regrest

Regrest - Client Micro HTTP

Client HTTP basé sur Micro Promise pour le navigateur et node.js

Caractéristiques

• Créer des XMLHttpRequests depuis le navigateur

• Faire des requêtes http depuis node.js

• Prend en charge l'API Promise

• Prise en charge TypeScript intégrée

Prise en charge du navigateur

Dernier ✔	Dernier ✔	Dernier ✔	Dernier ✔	Dernier ✔	11 ✔

NOTE

Si vous avez l'intention de prendre en charge Internet Explorer, assurez-vous d'avoir un poly-fill qui ajoute un objet Promise global

Installation

Utilisation de npm :

 $ npm installer le registre

En utilisant cdn :

 <script src="https://cdn.jsdelivr.net/npm/regrest/lib/index.umd.min.js"></script>

Exemple

Regrest est conçu pour être le moyen le plus simple possible de passer des appels http

Effectuer une requête GET

 // Importer en utilisant NodeJS ou CommonJS moduleconst regrest = require("regrest").default;// Ou en utilisant ES6 moduleimport regrest from "regrest";// Utiliser Promiseregrest
  .get("/homme/ours/cochon")
  // Imprime la chaîne de réponse brute
  .then((réponse) => console.log(réponse.text))
  // Affiche toute erreur si elle se produit
  .catch((error) => console.log(`*** Error: ${error}`));// Ou utilisez les nouveaux mots-clés async/awaitconst getGood = async () => {
  try {// Stocker la réponse dans une variableconst réponse = wait regrest.get("/foo/bar.json");// imprimer le réponse analyséeconsole.log(response.json);
  } catch (erreur) {// Imprimer toute erreur si cela se produitconsole.log(`*** Erreur : ${error}`);
  }};getGood();// Ou utiliser des rappels// NOUS NE FAISONS PAS CELA ICI

Effectuer une requête POST

 regretter
  .post("/comment", JSON.stringify({ nom : "Foo", commentaire : "Bar" }))
  .then((response) => console.log(response.status, réponse.statusText))
  .catch((erreur) => console.log(erreur));

Documentation

Méthodes pratiques

regrest.request(options)

regrest.get(url[, options])

regrest.head(url[, options])

regrest.post(url[, données[, options]])

regrest.put(url[, données[, options]])

regrest.delete(url[, options])

regrest.options(url[, options])

regrest.patch(url[, données[, options]])

options d'options

 // Les options par défaut sont marquées par *const options = {
  méthode : "GET", // *GET, POST, PUT, DELETE, etc.
  URL : "https://some-domain.com/api/",
  en-têtes : { "Content-Type": "application/json; charset=utf-8" }, // *{}
  paramètres : {UID : 9873},
  données : JSON.stringify(données), // *null
  maxRedirects : 10, // *5
  withCredentials : vrai, // *faux, vrai} ;

Attributs de l'objet de réponse

 {
  // Contient le code d'état de la réponse, par exemple 404 pour une ressource non trouvée, 200 pour un succès
  statut : 200,
  // Un message lié à l'attribut status, par exemple OK pour un status 200
  texte d'état : "OK",
  // Les en-têtes avec lesquels le serveur a répondu
  en-têtes : {},
  // Contenu de la réponse sous forme de chaîne
  texte: "",
  // Contenu de la réponse au format JSON
  json : {},
  // Contenu de la réponse en tant que Blob sur le navigateur et Buffer sur Node js
  arrayBuffer : instance de Blob || instance de Buffer,
  // Contenu de la réponse en tant que Blob
  blob : instance de Blob} ;

Gestion des erreurs

 regrest.get("/McNullington").catch((erreur) => {
  if (error.response) {/** * Une requête a été effectuée mais le serveur a répondu * avec un code d'état hors de la plage 2XX * `error.response` est une instance de l'objet de réponse */console.log(error.response. statut);console.log(error.response.statusText);console.log(error.response.headers);// ...
  } else if (error.request) {/** * Une requête a été effectuée, mais aucune réponse n'a été reçue * `error.request` est une instance de XMLHttpRequest sur le navigateur et une instance de * http.ClientRequest sur Node js */console .log(erreur.request);
  } else {// Quelque chose d'autre s'est produitconsole.log(error.message);
  }});