graphql-request vs urql vs apollo-client vs react-apollo
Bibliothèques de gestion de GraphQL
graphql-requesturqlapollo-clientreact-apolloPacchetti simili:

Bibliothèques de gestion de GraphQL

Ces bibliothèques facilitent l'interaction avec les API GraphQL en fournissant des outils pour effectuer des requêtes, gérer l'état et intégrer des données dans des applications JavaScript, notamment celles basées sur React. Elles simplifient le processus de récupération et de gestion des données, tout en offrant des fonctionnalités avancées comme la mise en cache et la gestion des erreurs.

Trend di download npm

3 Anni

Classifica GitHub Stars

Dettaglio statistiche

Pacchetto
Download
Stars
Dimensione
Issues
Pubblicazione
Licenza
graphql-request13,112,8486,121420 kB60il y a un anMIT
urql1,518,1508,985140 kB33il y a 2 moisMIT
apollo-client583,95619,781-410il y a 6 ansMIT
react-apollo167,0586,790-205il y a 7 ansMIT

Confronto funzionalità: graphql-request vs urql vs apollo-client vs react-apollo

Mise en cache

  • graphql-request:

    GraphQL Request ne dispose pas de mécanismes de mise en cache intégrés, ce qui signifie que chaque requête est effectuée à chaque fois, ce qui peut être un inconvénient pour les applications nécessitant des performances optimales.

  • urql:

    urql propose une approche de mise en cache flexible qui peut être configurée selon les besoins de l'application, permettant aux développeurs de choisir comment et quand les données doivent être mises en cache.

  • apollo-client:

    Apollo Client propose un système de mise en cache normalisé qui permet de stocker les résultats des requêtes et de les réutiliser, réduisant ainsi le nombre d'appels réseau et améliorant les performances de l'application.

  • react-apollo:

    React Apollo utilise le même système de mise en cache qu'Apollo Client, permettant une gestion efficace des données dans les composants React, avec des mises à jour automatiques lorsque les données changent.

Simplicité d'utilisation

  • graphql-request:

    GraphQL Request est très simple à utiliser et nécessite peu de configuration, ce qui le rend idéal pour les développeurs qui cherchent à effectuer des requêtes rapidement sans se soucier des détails complexes.

  • urql:

    urql est également facile à utiliser, avec une API simple qui permet aux développeurs de se concentrer sur la logique de leur application sans être submergés par des fonctionnalités inutiles.

  • apollo-client:

    Apollo Client peut être complexe à configurer en raison de ses nombreuses fonctionnalités. Il nécessite une certaine courbe d'apprentissage pour tirer pleinement parti de ses capacités.

  • react-apollo:

    React Apollo est conçu pour être utilisé avec React, ce qui facilite l'intégration dans les projets React existants, mais peut nécessiter une compréhension des concepts d'Apollo Client.

Extensibilité

  • graphql-request:

    GraphQL Request est moins extensible car il se concentre sur la simplicité et la légèreté, ce qui peut limiter les options pour des cas d'utilisation plus avancés.

  • urql:

    urql est conçu pour être hautement extensible, permettant aux développeurs d'ajouter des échanges personnalisés et de modifier le comportement de la bibliothèque selon leurs besoins.

  • apollo-client:

    Apollo Client est très extensible grâce à son écosystème riche et à ses plugins, permettant aux développeurs d'ajouter des fonctionnalités personnalisées selon leurs besoins.

  • react-apollo:

    React Apollo est extensible grâce à sa compatibilité avec Apollo Client, permettant aux développeurs d'utiliser des fonctionnalités avancées tout en restant dans l'écosystème React.

Gestion des erreurs

  • graphql-request:

    GraphQL Request offre une gestion des erreurs basique, mais les développeurs doivent gérer manuellement les erreurs dans leurs requêtes, ce qui peut être moins pratique pour des applications plus complexes.

  • urql:

    urql propose des outils pour gérer les erreurs de manière efficace, permettant aux développeurs de réagir aux erreurs de requête et de mutation de manière appropriée.

  • apollo-client:

    Apollo Client fournit des mécanismes robustes pour gérer les erreurs, y compris des hooks pour capturer et traiter les erreurs de requête de manière centralisée.

  • react-apollo:

    React Apollo hérite des capacités de gestion des erreurs d'Apollo Client, facilitant la gestion des erreurs directement dans les composants React.

Support de la communauté

  • graphql-request:

    GraphQL Request a une communauté plus petite, ce qui peut rendre le support moins accessible, mais sa simplicité compense souvent ce manque.

  • urql:

    urql a une communauté en croissance et une documentation claire, bien qu'elle soit moins établie que celle d'Apollo Client.

  • apollo-client:

    Apollo Client bénéficie d'une large communauté et d'une documentation exhaustive, ce qui facilite le support et l'apprentissage pour les nouveaux utilisateurs.

  • react-apollo:

    React Apollo, étant basé sur Apollo Client, bénéficie d'un bon support communautaire et de ressources d'apprentissage, ce qui en fait un choix populaire parmi les développeurs React.

Come scegliere: graphql-request vs urql vs apollo-client vs react-apollo

  • graphql-request:

    Optez pour GraphQL Request si vous recherchez une bibliothèque légère et simple pour effectuer des requêtes GraphQL sans configuration complexe. C'est parfait pour les projets plus petits ou lorsque vous avez besoin d'une solution rapide et efficace.

  • urql:

    Choisissez urql si vous souhaitez une bibliothèque flexible et extensible, avec un bon équilibre entre simplicité et fonctionnalités avancées. Elle est idéale pour les développeurs qui veulent personnaliser leur gestion des requêtes et des mises à jour de données.

  • apollo-client:

    Choisissez Apollo Client si vous avez besoin d'une solution complète avec des fonctionnalités avancées comme la mise en cache, la gestion des erreurs et l'intégration avec des outils comme Apollo Server. Il est idéal pour les applications complexes nécessitant une gestion d'état robuste.

  • react-apollo:

    Utilisez React Apollo si vous travaillez spécifiquement avec React et que vous souhaitez bénéficier d'une intégration étroite avec les composants React. Il offre des hooks et des composants pour faciliter la gestion des requêtes et des mutations dans vos composants React.

README per graphql-request

graphql-request

Minimal GraphQL client supporting Node and browsers for scripts or simple apps.

GitHub Action npm version

Highlights

  • Most simple & lightweight GraphQL client
  • Promise-based API (works with async / await)
  • Pure ESM package
  • First class TypeScript support
    • Including TypedDocumentNode
  • Isomorphic (works in both Node and Browsers)

Install

npm add graphql-request graphql

TypeScript Setup

This package uses package.exports. Therefore if you are a TypeScript user you must:

  1. have your tsconfig.json moduleResolution set to "bundler" or "node16"/"nodenext".
  2. Have your package.json type set to "module".

Quick Start

Send a GraphQL document using a static request function:

import { gql, request } from 'graphql-request'

const document = gql`
  {
    company {
      ceo
    }
  }
`
await request('https://api.spacex.land/graphql/', document)

The function can be passed a configuration object for more complex cases:

await request({
  url,
  document,
  variables,
  requestHeaders,
})

A class is available for constructing your own instances:

import { gql, GraphQLClient } from 'graphql-request'

const document = gql`
  {
    company {
      ceo
    }
  }
`
const endpoint = 'https://api.spacex.land/graphql/'
const client = new GraphQLClient(endpoint)
await client.request(document)

Examples

Node Version Support

We only (officially) support versions of Nodejs of the following status:

  • Current
  • LTS
  • Maintenance and end of life not yet reached

So for example on Oct 24 2023 that would mean these versions: 18, 20, 21.

Any issue that exists solely for an unsupported version of Nodejs will be rejected (not worked on).

Reference

⚠️ This reference is incomplete. Check out the examples for more reference material.

Configuration

ErrorPolicy

By default GraphQLClient will throw when an error is received. However, sometimes you still want to resolve the (partial) data you received. You can define errorPolicy in the GraphQLClient constructor.

const client = new GraphQLClient(endpoint, { errorPolicy: 'all' })
None (default)

Allow no errors at all. If you receive a GraphQL error the client will throw.

Ignore

Ignore incoming errors and resolve like no errors occurred

All

Return both the errors and data, only works with rawRequest.

IgnoreOperationName

OperationName has been introduced to address issues reported here Support operation name, However, on certain occasions this information may not be needed in requests. In such cases, you might consider ignoring operationName to avoid the extraction steps currently performed by a parsing operation when the document is provided in string format.

By default the GraphQLClient tries to extract the operationName from the document. You can define excludeOperationName in the constructor of GraphQLClient to avoid the extraction process if it is not needed. This can be useful if you don't use operationName and want to optimise queries by reducing the amount of computation as much as possible, especially if we are in a context where we are using documents in string format to reduce bundle size.

// example where the operation name is not ignored
const client = new GraphQLClient(endpoint, {
  method: 'POST',
})
// example in which the operation name is ignored
const client = new GraphQLClient(endpoint, {
  method: 'POST',
  excludeOperationName: true,
})

Knowledge Base

Why was the file upload feature taken away? Will it return?

In this issue we decided to make this library more stable and maintainable. In principal the feature is still in scope of this library and will make a return when we find time to do the feature right.

Why do I have to install graphql?

graphql-request uses methods exposed by the graphql package to handle some internal logic. On top of that, for TypeScript users, some types are used from the graphql package to provide better typings.

Do I need to wrap my GraphQL documents inside the gql template exported by graphql-request?

No. It is there for convenience so that you can get the tooling support like automatic formatting and syntax highlighting. You can use gql from graphql-tag if you need it for some reason too.

What sets graphql-request apart from other clients like Apollo, Relay, etc.?

graphql-request is the most minimal and simplest to use GraphQL client. It's perfect for small scripts or simple apps.

Compared to GraphQL clients like Apollo or Relay, graphql-request doesn't have a built-in cache and has no integrations for frontend frameworks. The goal is to keep the package and API as minimal as possible.

Project Stats

Package Installs

NPM Usage Trend of graphql-request

Repo Beats

Alt