L'intégration des couvertures dans un projet Apollo GraphQL peut améliorer considérablement votre flux de travail de développement, fournissant des informations précieuses sur votre couverture de code. En tant que fournisseur CoverAlls, je suis ravi de vous guider tout au long du processus, de la compréhension des bases à tirer parti des fonctionnalités avancées pour des résultats optimaux.
Comprendre CoverAlls et Apollo GraphQL
Avant de plonger dans le processus d'intégration, il est essentiel de saisir les principes fondamentaux de CoverAlls et Apollo GraphQL. CoverALLS est un service de suivi de couverture de code qui aide les développeurs à comprendre quelles parties de leur base de code sont exercées par des tests. Il fournit des rapports et des visualisations détaillés, vous permettant d'identifier les domaines qui ont besoin de plus de couverture de test.
D'un autre côté, Apollo GraphQL est une bibliothèque puissante pour construire des serveurs et des clients GraphQL. Il simplifie le processus de récupération et de gestion des données, ce qui facilite le développement d'applications évolutives et efficaces. En combinant des couvertures avec un projet Apollo GraphQL, vous pouvez vous assurer que vos requêtes, mutations et résolveurs GraphQL sont testés en profondeur.
Condition préalable
Avant d'intégrer CoverAlls à votre projet Apollo GraphQL, vous devrez avoir ce qui suit en place:
- Projet Apollo GraphQL:Vous devriez avoir un projet Apollo GraphQL existant configuré. Si vous êtes nouveau sur Apollo GraphQL, vous pouvez suivre la documentation officielle pour commencer.
- Framework de test:Vous aurez besoin d'un framework de test pour écrire et exécuter des tests pour votre projet Apollo GraphQL. Les choix populaires incluent la plaisanterie, le moka et le chai.
- Outil de couverture de code:Vous aurez également besoin d'un outil de couverture de code pour générer des rapports de couverture. Istanbul (également connu sous le nom de NYC) est un outil de couverture de code largement utilisé qui fonctionne bien avec la plupart des cadres de test.
Étape 1: Installez les dépendances
La première étape consiste à installer les dépendances nécessaires pour votre projet. Si vous utilisez Jest comme Framework de test, vous pouvez installer Istanbul en exécutant la commande suivante dans votre répertoire de projet:
Bash NPM Install - Save-Dev NYC
Étape 2: Configurer la couverture du code
Une fois que vous avez installé Istanbul, vous devrez le configurer pour générer des rapports de couverture pour votre projet Apollo GraphQL. Créer un.NycrcFichier à la racine de votre répertoire de projet et ajoutez la configuration suivante:
JSON {"étend": "@ istanbuljs / nyc-config-typescript", "all": true, "inclure": ["src / ** / *. js", "src / ** / *. ts"], "exclure": ["src / ** / *.
Cette configuration indique à Istanbul d'inclure tous les fichiers JavaScript et TypeScript dans leSRCRépertoire, à l'exclusion des fichiers de test.
Étape 3: Écrivez des tests
Il est maintenant temps d'écrire des tests pour votre projet Apollo GraphQL. Vous pouvez utiliser votre cadre de test de choix pour écrire des tests unitaires pour vos résolveurs, requêtes et mutations. Voici un exemple de test unitaire simple utilisant la plaisanterie:
`` `JavaScript Import {apollOserver} à partir de 'apollo-server'; import {typedefs, résolvers} de './schema';
décrire ('Apollo GraphQL Resolvers', () => {LET Server;
AVANTEACH (() => {server = new ApollOserver ({typedefs, résolvers});});
il ('devrait renvoyer une liste d'utilisateurs', async () => {const query =requête {utilisateurs {nom d'identification}};
const result = wait server.executeOperation ({query}); attendre (result.data.users) .tobeinstanceof (array);
}); }); `` '
Étape 4: générer des rapports de couverture
Une fois que vous avez écrit vos tests, vous pouvez générer des rapports de couverture à l'aide d'Istanbul. Ajoutez le script suivant à votrepackage.jsondéposer:
JSON {"Scripts": {"Test: Coverage": "NYC Jest"}}
Vous pouvez maintenant exécuter la commande suivante pour générer des rapports de couverture:
Bash NPM Run Test: Couverture
Cela exécutera vos tests et générera un rapport de couverture dans lecouvertureannuaire.
Étape 5: Intégrez les couvertures
Pour intégrer CoverAlls à votre projet Apollo GraphQL, vous devrez vous inscrire à un compte CoverAlls et installer le COVERALLS CLI. Vous pouvez installer le COVERALLS CLI en exécutant la commande suivante:
Bash NPM Install - Save-Dev CoverAlls
Ensuite, vous devrez configurer votre projet pour envoyer des rapports de couverture à CoverAlls. Ajoutez le script suivant à votrepackage.jsondéposer:
JSON {"Scripts": {"CoverAlls": "Cat ./coverage/lcov.info | coveralls"}}
Enfin, vous pouvez exécuter la commande suivante pour envoyer vos rapports de couverture à CoverAlls:
Bash NPM Run Coveralls
Fonctionnalités avancées
CoverAllS propose plusieurs fonctionnalités avancées qui peuvent vous aider à optimiser votre couverture de code. Voici quelques exemples:
- Couverture des succursales:Les couvertures peuvent vous montrer quelles branches de votre code sont exercées par des tests. Cela peut vous aider à identifier les domaines où vos tests peuvent manquer des cas de bord.
- Intégration de la demande d'extraction:Vous pouvez intégrer CoverAlls à votre flux de travail de demande de Pull pour vérifier automatiquement la couverture du code avant de fusionner les modifications. Cela peut vous aider à vous assurer que le nouveau code est testé de manière adéquate.
- Badges personnalisés:CoverAlls vous permet de générer des badges personnalisés que vous pouvez afficher sur votre fichier readme.md. Ces badges peuvent montrer la couverture globale de votre projet et d'autres mesures importantes.
Choisir les bonnes couvertures pour votre projet
En tant que fournisseur de couvertures, nous proposons une large gamme de couvertures pour répondre aux besoins de différents projets. L'un de nos produits populaires est leCoverall Type5 / 6. Cette couverture est conçue pour offrir une protection et un confort maximaux, ce qui le rend idéal pour les développeurs travaillant dans une variété d'environnements.
Le couvercle de type 5/6 est fabriqué à partir de matériaux de haute qualité résistants aux produits chimiques, aux abrasions et à d'autres dangers. Il propose un ajustement confortable et des poignets réglables et une ceinture, garantissant un ajustement sécurisé et confortable. De plus, la couverture est facile à nettoyer et à entretenir, ce qui en fait un choix pratique pour une utilisation à long terme.
Conclusion
L'intégration de CoverAlls avec un projet Apollo GraphQL est un processus simple qui peut fournir des informations précieuses sur votre couverture de code. En suivant les étapes décrites dans cet article de blog, vous pouvez vous assurer que vos requêtes, mutations et résolveurs GraphQL sont testés en profondeur. De plus, en choisissant les bonnes couvertures pour votre projet, vous pouvez améliorer votre protection et votre confort pendant le travail.
Si vous souhaitez en savoir plus sur nos produits CoverAlls ou si vous avez des questions sur l'intégration de CoverAlls à votre projet Apollo GraphQL, n'hésitez pas à nous contacter. Nous sommes ici pour vous aider à tirer le meilleur parti de votre flux de travail de développement et à assurer le succès de vos projets.
Références
- Documentation Apollo GraphQL
- Documentation CoverAlls
- Documentation Istanbul
- Documentation en plaisantage






