Vue Academy · Lektion

useMutation til dataændringer

useMutation(MUTATION), mutate(), strategier til opdatering af cache og optimistiske svar

Lektion 3 af 413 trin

useMutation til dataændringer er en gratis Vue Academy-lektion på CoddyKit. Dette er lektion 3 af 4. Du kan læse alle 3 lektioner i dette læringsspor gratis i deres fulde længde — derefter låser CoddyKit PRO alle lektioner op samt praktiske øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Den er en del af læringsforløbet i Vue Academy, og dine fremskridt synkroniseres på tværs af nettet og CoddyKit-appen. Vue Academy-kurset indeholder 4 lektioner i alt.

Ændring af data med mutationer

Forespørgsler læser data, mens mutationer ændrer dem – opretter, opdaterer eller sletter dem. Composable-funktionen useMutation kører en GraphQL-mutation og giver dig en mutate-funktion, som du kan kalde, når du er klar.

Grundlæggende useMutation

Angiv et mutationsdokument. I modsætning til useQuery kører det ikke med det samme – det returnerer en mutate-funktion, som du kalder ved en hændelse.

import { useMutation } from '@vue/apollo-composable'
import { gql } from '@apollo/client/core'

const { mutate } = useMutation(gql(
  'mutation { addPost { id } }'
))

Udløsning af mutationen

Kald mutate() fra en hændelseshåndterer, f.eks. ved afsendelse af en formular. Den returnerer et Promise, der løses med resultatet.

async function submit() {
  await mutate()
}

Videregivelse af variabler

Videregiv et objekt med variabler til mutate. Mutationsdokumentet erklærer dem med syntaksen $.

const { mutate } = useMutation(gql(
  'mutation($title: String!) { addPost(title: $title) { id title } }'
))
function add(title) {
  return mutate({ title })
}

Indlæsning og fejl

useMutation returnerer også refs for loading og error, så du kan deaktivere sendeknappen og vise fejl.

<template>
  <button :disabled="loading" @click="submit">Save</button>
  <p v-if="error">{{ error.message }}</p>
</template>

Reaktion på succes

onDone-hooket udløses efter en vellykket mutation — ryd en formular, vis en toastbesked, eller naviger væk.

const { mutate, onDone } = useMutation(ADD_POST)
onDone((res) => {
  console.log('Created', res.data.addPost.id)
})

Opdatering af cachen

Efter en mutation kan Apollo-cachen være forældet. Funktionen update lader dig ændre cachen direkte, så brugergrænsefladen afspejler ændringen uden at genhente data.

useMutation(ADD_POST, {
  update(cache, { data }) {
    const existing = cache.readQuery({ query: GET_POSTS })
    cache.writeQuery({
      query: GET_POSTS,
      data: { posts: [...existing.posts, data.addPost] }
    })
  }
})

Hvorfor update er bedre end refetch

En cache-update undgår en ekstra tur-retur til netværket. Det nye element vises med det samme, fordi du har skrevet det ind i den cache, som alle useQuery-kald læser fra.

Genkør forespørgsler i stedet

Hvis manuel redigering af cachen er for besværlig, kan du bruge refetchQueries til at køre bestemte forespørgsler igen, når mutationen er fuldført.

useMutation(ADD_POST, {
  refetchQueries: [{ query: GET_POSTS }]
})

Optimistiske svar

En optimisticResponse opdaterer brugergrænsefladen før serveren svarer ud fra en antagelse om succes. Hvis forespørgslen mislykkes, ruller Apollo automatisk ændringen tilbage.

mutate(
  { title: 'New' },
  {
    optimisticResponse: {
      addPost: { __typename: 'Post', id: 'temp', title: 'New' }
    }
  }
)

Hvorfor optimistisk brugergrænseflade er vigtig

Optimistiske opdateringer får appen til at føles øjeblikkelig — brugeren ser sin handling træde i kraft med det samme. Sammen med update erstattes det midlertidige element af de rigtige data fra serveren, når de ankommer.

Hurtigt tjek

Test din viden om mutationer.

Opsummering

Du har lært om mutationer:

  • useMutation returnerer en mutate-funktion, som du kalder ved hændelser.
  • Videregiv variabler til mutate(); brug loading/error og onDone.
  • Funktionen update redigerer cachen efter en mutation, så en ny hentning undgås.
  • optimisticResponse opdaterer brugergrænsefladen med det samme og ruller automatisk tilbage.
Gratis at komme i gang

Lær HTML med en AI-underviser — gratis

Skriv og kør rigtig kode i din browser, få øjeblikkelig hjælp fra en AI-underviser døgnet rundt, og fortsæt, hvor du slap, på web eller i appen.

Kurser
42
Lektioner
156

Ofte stillede spørgsmål

Er lektionen “useMutation til dataændringer” gratis?

Ja — alle 3 lektioner i læringssporet Vue Academy, inklusive “useMutation til dataændringer”, kan læses gratis i deres fulde længde her på webstedet. Derefter låser CoddyKit PRO alle lektioner op samt interaktive øvelser med en indbygget kodeeditor og en AI-underviser døgnet rundt. Vue Academy-kurset indeholder 4 lektioner i alt.

Hvad lærer jeg i “useMutation til dataændringer”?

useMutation(MUTATION), mutate(), strategier til opdatering af cache og optimistiske svar Du øver dig i Vue Academy med praktisk kode, som du kører direkte i browseren, og en AI-vejleder døgnet rundt besvarer dine spørgsmål, mens du arbejder dig gennem lektionen.

Skal jeg have erfaring for at begynde på Vue Academy?

Der kræves ingen tidligere erfaring. Vue Academy på CoddyKit er tilrettelagt for både begyndere og øvede, så du kan starte her eller fra begyndelsen og lære i dit eget tempo. Dette er lektion 3 af 4.

Hvor lang tid tager lektionen “useMutation til dataændringer”?

De fleste CoddyKit-lektioner tager cirka 5–10 minutter. Hver lektion er kort og interaktiv, så du gør løbende fremskridt og kan fortsætte, hvor du slap – på både web og app.

Kan jeg skrive og køre kode i denne Vue Academy-lektion?

Ja. Alle Vue Academy-lektioner har en indbygget kodeeditor, så du kan skrive og køre rigtig kode direkte i din browser og få øjeblikkelig feedback fra AI – uden lokal opsætning.

Alle lektioner i dette kursus

  1. Opsætning af Apollo Client i Vue 3
  2. useQuery til datahentning
  3. useMutation til dataændringer
  4. Realtidsabonnementer med useSubscription
← Tilbage til Vue Academy