Client GraphQL typé avec Apollo et urql
Utilisez des hooks et des opérations générés pour des requêtes sûres du point de vue des types
Client GraphQL typé avec Apollo et urql est une leçon TypeScript Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage TypeScript Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours TypeScript Academy comprend 4 leçons au total.
Le problème du typage côté client
Les clients GraphQL comme Apollo et urql renvoient par défaut des données de type any. La génération de code produit des hooks et des opérations typés qui rendent les requêtes entièrement sûres du point de vue des types.
// Without codegen: data is any
const { data } = useQuery(GET_USER);
data.user; // any — no safetyExtension des opérations pour Apollo
Ajoutez @graphql-codegen/typescript-react-apollo pour générer des hooks React typés pour chaque opération de vos fichiers .graphql.
npm install --save-dev @graphql-codegen/typescript-operations
npm install --save-dev @graphql-codegen/typescript-react-apollocodegen.yml pour les hooks Apollo
Indiquez à la génération de code vos fichiers d’opérations .graphql et le schéma afin de générer des hooks typés.
# codegen.yml
documents: "src/**/*.graphql"
generates:
src/generated/operations.ts:
plugins:
- typescript
- typescript-operations
- typescript-react-apolloÉcrire une requête typée
Écrivez votre opération GraphQL dans un fichier .graphql, puis utilisez le hook généré dans votre composant.
# src/queries/GetUser.graphql
query GetUser($id: ID!) {
user(id: $id) {
id
name
email
}
}Utiliser le hook généré
Importez le hook généré, qui est entièrement typé : les variables, les données, le chargement et l’erreur sont tous vérifiés par TypeScript.
import { useGetUserQuery } from "./generated/operations";
function UserCard({ id }: { id: string }) {
const { data, loading } = useGetUserQuery({ variables: { id } });
if (loading) return <p>Loading...</p>;
return <p>{data?.user?.name}</p>; // data.user: User | null — typed
}urql avec la génération de code
Avec urql, utilisez @graphql-codegen/typescript-urql pour générer des enveloppes de hooks typées.
npm install --save-dev @graphql-codegen/typescript-urql
# Similar codegen.yml configuration, generates useGetUserQuery for urqlTypedDocumentNode
L’approche la plus bas niveau : utilisez TypedDocumentNode de @graphql-typed-document-node/core pour associer des types aux nœuds de document sans hooks propres à un framework.
import { TypedDocumentNode } from "@graphql-typed-document-node/core";
const GetUserDoc: TypedDocumentNode<GetUserQuery, GetUserQueryVariables> = gql`...`;
// Works with Apollo, urql, and any GraphQL client that supports itTypes de fragments
La génération de code produit également des types pour les fragments GraphQL, ce qui permet une composition des fragments sûre du point de vue des types dans les composants.
# UserFields.graphql
fragment UserFields on User {
id
name
}
# Generated: UserFieldsFragment type — use as prop typeMutations typées
La génération de code produit également des hooks de mutation typés, avec des variables et des données de résultat typées.
import { useCreateUserMutation } from "./generated/operations";
const [createUser, { loading }] = useCreateUserMutation();
// createUser({ variables: { input: { name, email } } })
// — variables are fully typedMaintenir les opérations synchronisées
Lorsque le schéma change, relancez la génération de code. L’ajout d’une étape validate-queries détecte les opérations qui font référence à des champs supprimés ou renommés.
npx graphql-codegen --check
# or with graphql-inspector:
npx graphql-inspector validate ./src/**/*.graphql ./api/schema.graphqlRécapitulatif : clients GraphQL typés
La génération de code produit des hooks typés pour Apollo et urql à partir de vos fichiers d’opérations .graphql. Vous bénéficiez ainsi d’une sécurité de typage complète pour les variables, les données de requête et la structure des fragments — sans maintenance manuelle des types.
Vérification rapide
Que fournit un hook GraphQL typé généré par rapport à l’utilisation d’un document brut ?
Ce que vous avez appris
Les clients GraphQL typés utilisent la génération de code pour produire des hooks dont les variables et les données sont entièrement typées pour Apollo et urql. Écrivez les opérations dans des fichiers .graphql, exécutez la génération de code et obtenez une sécurité de typage de bout en bout, du schéma au composant.
Apprends TypeScript avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 101
- Leçons
- 352
Questions Fréquemment Posées
La leçon « Client GraphQL typé avec Apollo et urql » est-elle gratuite ?
Oui — le texte complet de « Client GraphQL typé avec Apollo et urql » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours TypeScript Academy, passe à CoddyKit PRO. Le cours TypeScript Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Client GraphQL typé avec Apollo et urql » ?
Utilisez des hooks et des opérations générés pour des requêtes sûres du point de vue des types Tu pratiques TypeScript Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer TypeScript Academy ?
Aucune expérience préalable n'est requise. TypeScript Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.
Combien de temps prend la leçon « Client GraphQL typé avec Apollo et urql » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon TypeScript Academy ?
Oui. Chaque leçon TypeScript Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Schéma GraphQL vers types TypeScript
- Résolveurs typés avec GraphQL Code Generator
- Client GraphQL typé avec Apollo et urql
- Sûreté des types de bout en bout : flux de travail fondé sur le schéma