regrest

Regrest - cliente Micro HTTP

Cliente HTTP baseado em Micro Promise para o navegador e node.js

Características

• Faça XMLHttpRequests do navegador

• Faça solicitações http de node.js

• Suporta a API Promise

• Suporte TypeScript integrado

Suporte ao navegador

Últimas ✔	Últimas ✔	Últimas ✔	Últimas ✔	Últimas ✔	11✔

OBSERVAÇÃO

Se você pretende oferecer suporte ao Internet Explorer, certifique-se de ter um poly-fill que adicione um objeto Promise global

Instalando

Usando npm:

 $ npm instalar arrependimento

Usando CDN:

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

Exemplo

Regrest foi projetado para ser a maneira mais simples possível de fazer chamadas http

Executando uma solicitação GET

 // Importe usando NodeJS ou CommonJS moduleconst regrest = require("regrest").default;// Ou usando ES6 moduleimport regrest from "regrest";// Use Promiseregrest
  .get("/homem/urso/porco")
  // Imprime a string de resposta bruta
  .then((resposta) => console.log(resposta.texto))
  // Imprime qualquer erro se ocorreu
  .catch((error) => console.log(`*** Error: ${error}`));// Ou use as novas palavras-chave async/awaitconst getGood = async () => {
  try {// Armazene a resposta em uma variávelconst response = await regrest.get("/foo/bar.json");// imprima o responseconsole.log(response.json) analisado;
  } catch (error) {// Imprime qualquer erro se ocorreuconsole.log(`*** Erro: ${error}`);
  }};getGood();// Ou use callbacks// NÃO FAZEMOS ISSO AQUI

Executando uma solicitação POST

 arrependimento
  .post("/comment", JSON.stringify({ nome: "Foo", comentário: "Bar" }))
  .then((resposta) => console.log(response.status, resposta.statusText))
  .catch((erro) => console.log(erro));

Documentação

Métodos de conveniência

arrependimento.request(opções)

arrependimento.get(url[, opções])

arrependimento.head(url[, opções])

arrependimento.post(url[, dados[, opções]])

arrependimento.put(url[, dados[, opções]])

arrependimento.delete(url[, opções])

arrependimento.options(url[, opções])

arrependimento.patch(url[, dados[, opções]])

Opções de opções

 // As opções padrão são marcadas com *const options = {
  método: "GET", // *GET, POST, PUT, DELETE, etc.
  url: "https://some-domain.com/api/",
  cabeçalhos: { "Content-Type": "application/json; charset=utf-8" }, // *{}
  parâmetros: { UID: 9873},
  dados: JSON.stringify(dados), // *nulo
  maxRedirects: 10, // *5
  withCredentials: true, // *false, true};

Atributos do objeto de resposta

 {
  // Contém o código de status da resposta, por exemplo, 404 para um recurso não encontrado, 200 para um sucesso
  status: 200,
  // Uma mensagem relacionada ao atributo status, por exemplo, OK para um status 200
  statusText: "OK",
  // Os cabeçalhos com os quais o servidor respondeu
  cabeçalhos: {},
  //Conteúdo da resposta como uma string
  texto: "",
  // Conteúdo da resposta como JSON
  json: {},
  // Conteúdo de resposta como Blob no navegador e Buffer no Node js
  arrayBuffer: instância do Blob || instância de buffer,
  // Responde o conteúdo como Blob
  blob: instância de Blob};

Tratamento de erros

 arrependimento.get("/McNullington").catch((erro) => {
  if (error.response) {/** * Uma solicitação foi feita, mas o servidor respondeu * com código de status fora do intervalo 2XX * `error.response` é uma instância do objeto de resposta */console.log(error.response. status);console.log(error.response.statusText);console.log(error.response.headers);// ...
  } else if (error.request) {/** * Uma solicitação foi feita, mas nenhuma resposta foi recebida * `error.request` é uma instância de XMLHttpRequest no navegador e uma instância de * http.ClientRequest no Node js */console .log(erro.solicitação);
  } else {// Algo mais aconteceuconsole.log(error.message);
  }});