Page traduite Le contenu de cette page peut être déprécié.
La méthode fetch
La méthode fetch est utilisée pour remplir le store avant de render la page, c'est similaire à asyncData sauf que cela ne remplit pas le data du composant.
Nuxt >= 2.12
Avec l'arrivée de la v2.12 de Nuxt, nous avons droit à un nouveau hook disponible dans tous les composants Vue: fetch.
fetch(context) a été déprécié, à la place on peut utiliser un middleware anonyme dans la page: middleware(context)Quand utiliser fetch?
À chaque fois que l'on a besoin d'avoir de la data asynchrone. fetch est appelé côté serveur pour render les routes et côté client lors de la navigation.
Il expose $fetchState au niveau du composant:
-
$fetchState.pending:Boolean, permet d'afficher un placeholder pendant que fetch est appelé (côté client). -
$fetchState.error:nullouError, vous permet d'afficher un message d'erreur -
$fetchState.timestamp:Integer, l'horodatage du dernier fetch, utile en combinaison aveckeep-alivepour de la mise en cache.
Si vous souhaitez appeler le hook fetch depuis votre template, utilisez:
<button @click="$fetch">Rafraîchir</button>
ou la méthode dans le composant:
// méthode dans la section script
export default {
methods: {
refresh() {
this.$fetch()
}
}
}
On peut accéder au context de Nuxt à l'intérieur du hook fetch en utilisant this.$nuxt.context.
Options
-
fetchOnServer:BooleanouFunction(par défaut:true), appellefetch()lors d'un render de page côté serveur -
fetchDelay:Integer(défaut:200), définit un temps d'exécution minimal en millisecondes (pour éviter les flashs)
Quand
fetchOnServer est falsy (false ou retourne false), fetch sera appelé uniquement côté client et $fetchState.pending retournera true lors d'un render côté serveur du composant.<script>
export default {
data() {
return {
posts: []
}
},
async fetch() {
this.posts = await this.$http.$get(
'https://jsonplaceholder.typicode.com/posts'
)
},
fetchOnServer: false
}
</script>
Editer cette page sur GitHub
Mise à jour le lun. 28 février 2022
Leoš Literák
Trizotti
Clément Ollivier
Sébastien Chopin
Marcello Bachechi
Rodolphe
Thomas Underwood
Shek Evgeniy
felipesuri
Lukasz Formela
Hugo Torzuoli
Sylvain Marroufin
Kareem Dabbeet
tramplay
Daniel Roe
verebelyicsaba
Adam
Nate Butler
Sandra Rodgers
Arpit Patidar
Matthew Kuehn
Steven DUBOIS
Travis Lindsey
syagawa
Maxime
かる
Al Power
Florent Delerue
quanghm
José Manuel Casani Guerra
Unai Mengual
kazuya kawaguchi
Michael Lynch
Tomachi
pooya parsa
Meir Roth
Brett
Adam Miedema
Thomas Bnt
Kazuki Furukawa
Anthony Ruelle
Christophe Carvalho Vilas-Boas
Roman Harmyder