Simuler une API GraphQL

Clic droit sur un dossier ▸ Ajouter ▸ Serveur GraphQL.

Configurer

Champ	Rôle
Schéma	Les définitions de types, en SDL
Résolveurs simulés	Un objet JSON dont les clés sont de la forme Type.champ, par exemple Query.pets
Script de résolution	Du JavaScript recevant (parent, args, context)

Le script l’emporte sur les valeurs canned quand il est renseigné : c’est ce qui permet de faire varier la réponse selon les arguments reçus.

Valeurs canned

Le plus rapide : le schéma décrit la forme, les résolveurs donnent le contenu.

type Animal { id: ID!, nom: String!, espece: String! }
type Query { animaux: [Animal!]! }

{
  "Query.animaux": [
    { "id": "1", "nom": "Mistigri", "espece": "chat" },
    { "id": "2", "nom": "Rex", "espece": "chien" }
  ]
}

Script de résolution

Quand la réponse doit dépendre de l’entrée :

// (parent, args, context)
if (args.espece) {
  return animaux.filter((a) => a.espece === args.espece);
}
return animaux;

Abonnements

Les abonnements déclarés dans le schéma sont servis eux aussi : un client peut s’y connecter et recevoir les messages émis.

Dans un scénario

Les actions Serveur GraphQL et Fermeture serveur GraphQL hébergent le service pour la durée du scénario. Voir Serveurs hébergés.

À quoi ça sert

Développer un front avant que le back n’existe, reproduire une réponse d’erreur difficile à provoquer en recette, ou figer un jeu de données pour un test déterministe — sans dépendre d’un service distant.