graphql-request vs urql vs apollo-client vs react-apollo
Bibliotecas de Gerenciamento de Estado GraphQL
graphql-requesturqlapollo-clientreact-apolloBenzer Paketler:

Bibliotecas de Gerenciamento de Estado GraphQL

As bibliotecas de gerenciamento de estado GraphQL são ferramentas que facilitam a interação entre aplicações front-end e servidores GraphQL. Elas permitem que os desenvolvedores façam consultas e mutações de dados de forma eficiente, gerenciando o estado da aplicação e a sincronização de dados. Essas bibliotecas oferecem abstrações que simplificam o processo de comunicação com APIs GraphQL, melhorando a experiência do desenvolvedor e a performance da aplicação.

npm İndirme Trendi

3 Yıl

GitHub Stars Sıralaması

İstatistik Detayı

Paket
İndirmeler
Stars
Boyut
Issues
Yayın Tarihi
Lisans
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

Özellik Karşılaştırması: graphql-request vs urql vs apollo-client vs react-apollo

Gerenciamento de Cache

  • graphql-request:

    O GraphQL Request não possui um sistema de cache embutido, o que significa que cada requisição é feita diretamente ao servidor. Isso pode ser uma vantagem em aplicações onde a simplicidade é priorizada, mas pode resultar em mais chamadas de rede se não for gerenciado manualmente.

  • urql:

    O urql oferece um sistema de cache leve e personalizável, permitindo que os desenvolvedores escolham como os dados são armazenados e recuperados. Isso oferece flexibilidade para otimizar o desempenho da aplicação conforme necessário.

  • apollo-client:

    O Apollo Client possui um sistema de gerenciamento de cache robusto que permite armazenar e reutilizar dados de consultas, melhorando a performance da aplicação. Ele oferece funcionalidades como cache normalizado, que permite que os dados sejam acessados de forma eficiente, e suporte a atualizações automáticas do cache quando os dados são modificados.

  • react-apollo:

    O React Apollo utiliza o cache do Apollo Client para gerenciar o estado da aplicação. Ele permite que os componentes se atualizem automaticamente quando os dados no cache mudam, facilitando a sincronização entre a interface do usuário e o estado da aplicação.

Facilidade de Uso

  • graphql-request:

    O GraphQL Request é extremamente simples e fácil de usar, com uma API minimalista que permite fazer requisições com apenas algumas linhas de código. É ideal para desenvolvedores que desejam uma solução rápida e direta.

  • urql:

    O urql é fácil de usar e oferece uma API clara, mas pode exigir um pouco mais de configuração inicial em comparação com o Apollo Client. No entanto, sua flexibilidade pode ser uma vantagem para projetos que precisam de personalização.

  • apollo-client:

    O Apollo Client é considerado fácil de usar, especialmente para desenvolvedores que já estão familiarizados com GraphQL. Sua documentação abrangente e exemplos práticos ajudam na rápida adoção e integração em projetos.

  • react-apollo:

    O React Apollo é projetado para ser intuitivo para desenvolvedores React, oferecendo hooks e componentes que se integram perfeitamente ao ciclo de vida do React. Isso facilita a implementação de consultas e mutações em componentes.

Extensibilidade

  • graphql-request:

    O GraphQL Request é uma biblioteca minimalista e não possui muitos pontos de extensão. É ideal para projetos simples, mas pode não ser a melhor escolha se você precisar de funcionalidades avançadas.

  • urql:

    O urql é projetado para ser extensível e modular, permitindo que você adicione plugins e customize o comportamento das requisições. Isso o torna uma escolha forte para aplicações que precisam de uma abordagem mais personalizada.

  • apollo-client:

    O Apollo Client é altamente extensível, permitindo que os desenvolvedores adicionem funcionalidades personalizadas através de links e plugins. Isso é útil para integrar middleware ou manipular requisições e respostas de forma personalizada.

  • react-apollo:

    O React Apollo é extensível através de hooks personalizados e componentes de ordem superior, permitindo que você crie soluções adaptadas às suas necessidades específicas de gerenciamento de estado e dados.

Suporte a Subscriptions

  • graphql-request:

    O GraphQL Request não oferece suporte nativo a subscriptions, pois é uma biblioteca focada em requisições simples. Para aplicações que precisam de funcionalidades em tempo real, pode ser necessário integrar outra solução.

  • urql:

    O urql também suporta subscriptions, permitindo que os desenvolvedores implementem atualizações em tempo real em suas aplicações. Isso é feito de forma modular, permitindo que você escolha como deseja gerenciar as subscriptions.

  • apollo-client:

    O Apollo Client oferece suporte completo a subscriptions, permitindo que as aplicações recebam atualizações em tempo real de dados. Isso é crucial para aplicações que precisam de interatividade e atualizações dinâmicas.

  • react-apollo:

    O React Apollo suporta subscriptions através do Apollo Client, permitindo que os componentes se atualizem automaticamente quando novos dados são recebidos. Isso facilita a construção de aplicações reativas e interativas.

Desempenho

  • graphql-request:

    O GraphQL Request é leve e rápido, mas não possui otimizações de cache, o que pode resultar em mais chamadas de rede. É ideal para aplicações que não exigem um gerenciamento de estado complexo.

  • urql:

    O urql é projetado para ser leve e rápido, com um sistema de cache que pode ser configurado para atender às necessidades específicas da aplicação. Isso permite que os desenvolvedores otimizem o desempenho conforme necessário.

  • apollo-client:

    O Apollo Client é otimizado para desempenho, especialmente em aplicações complexas, com um sistema de cache eficiente que minimiza chamadas de rede. No entanto, pode haver uma curva de aprendizado para configurar corretamente o cache e as otimizações.

  • react-apollo:

    O React Apollo se beneficia do desempenho do Apollo Client, oferecendo um gerenciamento de estado eficiente e atualizações automáticas que melhoram a experiência do usuário. A integração com o React permite que as atualizações sejam rápidas e responsivas.

Nasıl Seçilir: graphql-request vs urql vs apollo-client vs react-apollo

  • graphql-request:

    Escolha o GraphQL Request se você procura uma biblioteca leve e simples para fazer requisições GraphQL. É excelente para projetos pequenos ou quando você deseja uma abordagem minimalista sem a sobrecarga de funcionalidades adicionais.

  • urql:

    Escolha o urql se você precisa de uma biblioteca flexível e extensível que permita personalizar o comportamento das requisições. É uma boa escolha para aplicações que exigem uma abordagem modular e que podem se beneficiar de uma configuração mais leve.

  • apollo-client:

    Escolha o Apollo Client se você precisar de uma solução completa que inclua gerenciamento de cache, suporte a subscriptions e integração com o React. É ideal para aplicações que requerem um gerenciamento de estado complexo e uma rica funcionalidade de consulta.

  • react-apollo:

    Escolha o React Apollo se você está construindo uma aplicação React e deseja uma integração profunda com o React, incluindo hooks e componentes de ordem superior. É ideal para desenvolvedores que já estão familiarizados com o ecossistema Apollo e querem aproveitar suas funcionalidades no React.

graphql-request için README

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