regrest

Regrest - Cliente Micro HTTP

Cliente HTTP basado en Micro Promise para el navegador y node.js

Características

• Hacer XMLHttpRequests desde el navegador

• Realizar solicitudes http desde node.js

• Soporta la API de promesa

• Soporte integrado para TypeScript

Soporte del navegador

Lo último ✔	Lo último ✔	Lo último ✔	Lo último ✔	Lo último ✔	11 ✔

NOTA

Si tiene la intención de admitir Internet Explorer, asegúrese de tener un polirrelleno que agregue un objeto Promise global

Instalación

Usando npm:

 $ npm instalar regrest

Usando CDN:

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

Ejemplo

Regrest está diseñado para ser la forma más sencilla posible de realizar llamadas http

Realizar una solicitud GET

 // Importar usando el módulo NodeJS o CommonJSconst regrest = require("regrest").default;// O usando el módulo ES6import regrest from "regrest";// Usar Promiseregrest
  .get("/hombre/oso/cerdo")
  // Imprime la cadena de respuesta sin formato
  .entonces((respuesta) => console.log(respuesta.texto))
  // Imprime cualquier error si ocurre
  .catch((error) => console.log(`*** Error: ${error}`));// O use las nuevas palabras clave async/awaitconst getGood = async () => {
  intente {// Almacene la respuesta en una variableconst respuesta = await regrest.get("/foo/bar.json");// imprima la respuesta analizadaconsole.log(response.json);
  } catch (error) {// Imprime cualquier error si ocurreconsole.log(`*** Error: ${error}`);
  }};getGood();// O usar devoluciones de llamada// NO HACEMOS ESO AQUÍ

Realizar una solicitud POST

 arrepentimiento
  .post("/comentario", JSON.stringify({ nombre: "Foo", comentario: "Bar" }))
  .entonces((respuesta) => console.log(respuesta.status, respuesta.statusText))
  .catch((error) => console.log(error));

Documentación

Métodos de conveniencia

solicitud.de pesar(opciones)

regrest.get(url[, opciones])

regrest.head(url[, opciones])

regrest.post(url[, datos[, opciones]])

regrest.put(url[, datos[, opciones]])

regrest.delete(url[, opciones])

regrest.opciones(url[, opciones])

regrest.patch(url[, datos[, opciones]])

Opciones opciones

 // Las opciones predeterminadas están marcadas con *const options = {
  método: "OBTENER", // *OBTENER, PUBLICAR, PONER, ELIMINAR, etc.
  URL: "https://algun-dominio.com/api/",
  encabezados: { "Tipo de contenido": "aplicación/json; charset=utf-8" }, // *{}
  parámetros: {UID: 9873},
  datos: JSON.stringify(datos), // *nulo
  maxRedirects: 10, // *5
  withCredentials: verdadero, // *falso, verdadero};

Atributos del objeto de respuesta

 {
  // Contiene el código de estado de la respuesta, por ejemplo, 404 para un recurso no encontrado, 200 para un éxito
  estado: 200,
  // Un mensaje relacionado con el atributo de estado, por ejemplo, OK para un estado 200
  texto de estado: "OK",
  // Los encabezados con los que respondió el servidor
  encabezados: {},
  // Contenido de la respuesta como una cadena
  texto: "",
  // Contenido de la respuesta como JSON
  json: {},
  // Contenido de respuesta como Blob en el navegador y Buffer en Node js
  arrayBuffer: instancia de Blob || instancia de búfer,
  // Responder contenido como Blob
  blob: instancia de Blob};

Manejo de errores

 regrest.get("/McNullington").catch((error) => {
  if (error.response) {/** * Se realizó una solicitud pero el servidor respondió * con un código de estado fuera del rango 2XX * `error.response` es una instancia del objeto de respuesta */console.log(error.response. estado);console.log(error.response.statusText);console.log(error.response.headers);// ...
  } else if (error.request) {/** * Se realizó una solicitud, pero no se recibió respuesta * `error.request` es una instancia de XMLHttpRequest en el navegador y una instancia de * http.ClientRequest en Node js */console .log(error.solicitud);
  } else {// Algo más sucedióconsole.log(error.message);
  }});