Realtime subscriptions met useSubscription
Een WebSocket-link instellen, useSubscription() gebruiken en subscription-data samenvoegen met reactieve state.
Realtime subscriptions met useSubscription is een gratis Vue Academy-les op CoddyKit. Dit is les 4 van 4. Je kunt 3 lessen uit dit leerpad gratis volledig lezen — daarna ontgrendelt CoddyKit PRO alle lessen, plus praktische oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject Vue Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus Vue Academy bevat in totaal 4 lessen.
Realtime met abonnementen
GraphQL-abonnementen sturen gegevens van de server naar de client via een blijvende verbinding. Waar query's één keer gegevens ophalen, sturen abonnementen voortdurend wijzigingen — ideaal voor chat, livefeeds en meldingen.
WebSocket-transport
Abonnementen hebben een langdurige verbinding nodig en gebruiken daarom WebSockets in plaats van HTTP. De bibliotheek graphql-ws biedt het moderne protocol via GraphQLWsLink.
npm install graphql-wsDe WebSocket-link maken
Wikkel een client van graphql-ws in een GraphQLWsLink die verwijst naar het wss://-eindpunt voor abonnementen.
import { GraphQLWsLink } from '@apollo/client/link/subscriptions'
import { createClient } from 'graphql-ws'
const wsLink = new GraphQLWsLink(createClient({
url: 'wss://api.example.com/graphql'
}))Het transportprobleem
Query's en mutaties moeten nog steeds via HTTP gaan, terwijl abonnementen via WebSocket gaan. Je kunt niet één link voor alles gebruiken — je moet verkeer splitsen op basis van het bewerkingstype.
Links splitsen
De functie split routeert elke bewerking: abonnementen naar de WebSocket-link en al het overige naar de HTTP-link, op basis van de geparseerde bewerkingsdefinitie.
import { split, HttpLink } from '@apollo/client/core'
import { getMainDefinition } from '@apollo/client/utilities'
const httpLink = new HttpLink({ uri: '/graphql' })
const link = split(
({ query }) => {
const def = getMainDefinition(query)
return def.kind === 'OperationDefinition' && def.operation === 'subscription'
},
wsLink,
httpLink
)De gesplitste link in de client opnemen
Geef de gecombineerde link door aan de Apollo-client in plaats van een gewone uri. Nu weet de client hoe elke bewerking moet worden gerouteerd.
const apolloClient = new ApolloClient({
link,
cache: new InMemoryCache()
})Basisprincipes van useSubscription
De useSubscription-composable opent de gegevensstroom en retourneert een reactieve status. Net als useQuery levert deze result, loading en error.
import { useSubscription } from '@vue/apollo-composable'
import { gql } from '@apollo/client/core'
const { result } = useSubscription(gql(
'subscription { messageAdded { id text } }'
))Elke binnenkomende gebeurtenis afhandelen
Gebruik de onResult-hook om te reageren op elke binnenkomende gebeurtenis zodra die aankomt — de natuurlijke plek om gegevens uit de gegevensstroom af te handelen.
const { onResult } = useSubscription(MESSAGE_ADDED)
onResult((res) => {
console.log('New message', res.data.messageAdded)
})Gegevens in een reactieve array plaatsen
Een veelgebruikt patroon: houd lokaal een reactieve array bij en voeg elke nieuwe gebeurtenis eraan toe, zodat het sjabloon een actuele, groeiende lijst weergeeft.
const messages = ref([])
const { onResult } = useSubscription(MESSAGE_ADDED)
onResult((res) => {
messages.value.push(res.data.messageAdded)
})Variabelen voor abonnementen
Abonnementen accepteren variabelen net als query's — abonneer je bijvoorbeeld op berichten voor één chatruimte.
useSubscription(
gql('subscription($room: ID!) { messageAdded(room: $room) { text } }'),
{ room: 'general' }
)Abonnementen versus polling
Polling haalt een query volgens een tijdschema opnieuw op; abonnementen sturen alleen gegevens wanneer er iets verandert. Abonnementen zijn efficiënter voor echte realtimegegevens, terwijl polling eenvoudiger is wanneer bijna-realtime voldoende is.
Korte toets
Toets je kennis van abonnementen.
Samenvatting
Je hebt realtimeabonnementen geleerd:
- Abonnementen sturen gegevens via WebSockets met GraphQLWsLink (graphql-ws).
- Gebruik split() om abonnementen via WS te verzenden en query's en mutaties via HTTP.
- useSubscription retourneert een reactief result met onResult voor elke binnenkomende gebeurtenis.
- Voeg binnenkomende gebeurtenissen toe aan een reactieve array voor een actuele lijst.
Leer HTML met een AI-tutor — gratis
Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.
- Cursussen
- 42
- Lessen
- 156
Veelgestelde vragen
Is de les “Realtime subscriptions met useSubscription” gratis?
Ja — je kunt hier op het web alle 3 lessen van het leerpad Vue Academy, waaronder “Realtime subscriptions met useSubscription”, gratis volledig lezen. Daarna ontgrendelt CoddyKit PRO alle lessen, plus interactieve oefeningen met een ingebouwde code-editor en een AI-tutor die 24/7 beschikbaar is. De cursus Vue Academy bevat in totaal 4 lessen.
Wat leer ik in “Realtime subscriptions met useSubscription”?
Een WebSocket-link instellen, useSubscription() gebruiken en subscription-data samenvoegen met reactieve state. Je oefent met Vue Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.
Heb ik ervaring nodig om met Vue Academy te beginnen?
Ervaring vooraf is niet nodig. Vue Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 4 van 4.
Hoe lang duurt de les “Realtime subscriptions met useSubscription”?
De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.
Kan ik code schrijven en uitvoeren in deze les over Vue Academy?
Ja. Elke les over Vue Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.
Alle lessen in deze cursus
- Apollo Client instellen in Vue 3
- useQuery voor het ophalen van data
- useMutation voor datawijzigingen
- Realtime subscriptions met useSubscription