为什么 Ky 是现代 HTTP 请求的 Axios 和 Fetch 的最佳替代品

Quand il s'agit de gérer les requêtes HTTP en JavaScript, Axios et Fetch sont depuis longtemps les outils incontournables. Cependant, il existe une alternative puissante et moderne que les développeurs devraient envisager —  Ky. Léger et doté de fonctionnalités avancées, Ky rend le traitement des requêtes HTTP plus facile et plus efficace. Dans cet article, nous expliquerons pourquoi Ky se démarque, avec des comparaisons directes avec Axios et Fetch API.

1. Présentation des API Ky, Axios et Fetch

Axios

Axios est un client HTTP populaire basé sur des promesses pour JavaScript. Il simplifie les requêtes HTTP en offrant des fonctionnalités telles que l'analyse automatique JSON, les intercepteurs de requêtes et les délais d'attente personnalisés. Cependant, la taille de son fichier peut devenir un inconvénient, notamment pour les applications légères.

Récupérer l'API

Fetch est une API de navigateur intégrée permettant d'effectuer des requêtes HTTP. Bien que largement utilisé, Fetch présente certaines limites : il n'inclut pas la gestion des erreurs par défaut ni les tentatives intégrées, ce qui oblige les développeurs à écrire du code supplémentaire, même pour les fonctionnalités de base.

Ky

Ky est une alternative légère (157 ~ Ko) à Axios et Fetch, construite sur Fetch mais offrant une API plus riche en fonctionnalités. Avec des tentatives intégrées, une gestion simplifiée des erreurs et des hooks de requête personnalisables, Ky établit un équilibre entre simplicité et puissance.

Pourquoi choisir Ky ?

• Léger : seulement 157 ~ Ko, idéal pour les applications sensibles aux performances.
• Modern : Construit sur l'API Fetch mais avec de meilleurs paramètres par défaut.
• Support de nouvelle tentative : tentatives automatiques en cas d'échec des demandes.
• Hooks : Manipulation facile des requêtes et des réponses avec les hooks beforeRequest et afterResponse.

2. Pourquoi Ky est meilleur : principales caractéristiques et avantages

Léger et performant

Cela fait de Ky un excellent choix pour les applications où les performances et la taille du bundle sont critiques. Bien qu'il soit léger, Ky ne sacrifie pas les fonctionnalités essentielles telles que les tentatives et la gestion des erreurs.

API simple, fonctionnalités puissantes

La syntaxe de Ky est aussi simple que Fetch, mais elle offre plus de puissance intégrée. Par exemple, faire une requête GET avec Ky est aussi simple que :

import ky from 'ky';
const data = await ky.get('https://api.example.com/data').json();

Pourquoi est-ce mieux que Fetch ?

• Analyse JSON automatique : Pas besoin d'analyser manuellement la réponse.
• Gestion des erreurs : Ky renvoie des erreurs significatives pour les codes HTTP comme 404 ou 500.
• Retries : Ky réessaye automatiquement les requêtes ayant échoué, contrairement à Fetch, qui échoue silencieusement.

Nouvelles tentatives intégrées

Ky est livré avec une prise en charge intégrée des nouvelles tentatives, une fonctionnalité cruciale pour gérer les conditions de réseau peu fiables. Axios propose également une fonctionnalité de nouvelle tentative, mais vous devez utiliser un plugin supplémentaire ou le configurer vous-même. En revanche, Ky fournit cette fonctionnalité par défaut sans configuration.

await ky.get('https://api.example.com/data', { retry: 2 });

Dans cet exemple, Ky réessayera la requête jusqu'à 2 fois en cas d'échec, sans aucune configuration supplémentaire.

3. beforeRequest et afterResponse : la puissance des hooks dans Ky

L'une des fonctionnalités les plus intéressantes de Ky est son système de hooks, en particulier beforeRequest et afterResponse. Ces hooks vous donnent un contrôle total sur vos requêtes et réponses HTTP sans avoir besoin d'un middleware externe, dont Axios a souvent besoin.

beforeRequest Hook : améliorez facilement les demandes

Avec Ky, vous pouvez facilement modifier les requêtes sortantes à l'aide du hook beforeRequest. Que vous ayez besoin d'ajouter des jetons d'authentification ou de modifier des en-têtes, beforeRequest vous facilite la tâche.

Exemple : Ajout d'un jeton d'autorisation à chaque demande.

ky.extend({
  hooks: {
    beforeRequest: [
      request => {
        const token = localStorage.getItem('authToken');
        request.headers.set('Authorization', `Bearer ${token}`);
      }
    ]
  }
});

Cela réduit le code répétitif, ce qui facilite la gestion de l'authentification à l'échelle mondiale.

afterResponse Hook : simplifiez la gestion des réponses

Avec le hook afterResponse, vous pouvez manipuler les réponses dans l'ensemble de votre application. Ce hook est particulièrement utile pour gérer les tentatives sur des codes d'état spécifiques, comme l'actualisation des jetons expirés.

Exemple : Actualisation automatique d'un token expiré sur une réponse 401 non autorisée.

ky.extend({
  hooks: {
    afterResponse: [
      async (request, options, response) => {
        if (response.status === 401) {
          const newToken = await refreshAuthToken();
          request.headers.set('Authorization', `Bearer ${newToken}`);
          return ky(request);
        }
      }
    ]
  }
});

Avec cette configuration, vous pouvez actualiser les jetons de manière transparente sans dupliquer la logique dans votre application.

4. Error Handling: Ky vs Axios vs Fetch API

Axios

Axios provides decent error handling via interceptors, but it lacks the simplicity that Ky offers out of the box. Axios often requires custom logic for retries and error status code handling.

Fetch API

Fetch’s error handling is limited by default. It doesn’t throw errors for HTTP status codes like 404 or 500, forcing developers to check response statuses manually.

Ky

Ky excels in error handling. It automatically throws errors for non-2xx HTTP responses and provides retry functionality for failed requests without needing additional code. This makes Ky a robust solution for handling errors elegantly.

try {
  const data = await ky.get('https://api.example.com/data').json();
} catch (error) {
  console.error('Request failed:', error);
}

Ky wraps the entire request in a promise, automatically throwing an error if the response status code indicates a failure, which simplifies debugging.

5. Practical Examples: Ky in Action

Let’s put Ky to the test with a few practical examples that showcase its simplicity and power.

Example 1: Making a GET Request

const response = await ky.get('https://api.example.com/items').json();
console.log(response);

Ky automatically handles JSON parsing and throws an error for any non-2xx status codes, which Fetch does not.

Example 2: POST Request with Retries

const response = await ky.post('https://api.example.com/create', {
  json: { name: 'Ky' },
  retry: 3
}).json();
console.log(response);

Ky retries the POST request up to 3 times if it fails, offering better reliability than Fetch or Axios without extra configuration.

6. Conclusion: Is Ky Worth the Switch?

If you’re looking for a modern , lightweight , and feature-packed solution for making HTTP requests in JavaScript, Ky is an excellent choice. While Axios and Fetch are still widely used, Ky offers key advantages like automatic retries, hooks for customizing requests and responses, and better default error handling.

For developers who prioritize simplicity , performance , and control over HTTP requests, Ky is definitely worth considering as a primary tool in your JavaScript projects.

For more examples and detailed API information, you can visit https://www.npmjs.com/package/ky.

以上是为什么 Ky 是现代 HTTP 请求的 Axios 和 Fetch 的最佳替代品的详细内容。更多信息请关注PHP中文网其他相关文章！