regrest

Regrest — клиент Micro HTTP

HTTP-клиент на основе Micro Promise для браузера и node.js

Функции

• Делайте XMLHttpRequests из браузера

• Делайте http-запросы из node.js

• Поддерживает API обещаний

• Встроенная поддержка TypeScript.

Поддержка браузера

Последние ✔	Последние ✔	Последние ✔	Последние ✔	Последние ✔	11 ✔

ПРИМЕЧАНИЕ

Если вы собираетесь поддерживать Internet Explorer, обязательно используйте полизаполнение, добавляющее глобальный объект Promise .

Установка

Использование НПМ:

 $ npm регистрация установки

Использование CDN:

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

Пример

Regrest разработан как самый простой способ выполнения http-вызовов.

Выполнение GET запроса

 // Импорт с использованием NodeJS или CommonJS modconst regrest = require("regrest").default;// Или с использованием ES6 modimport regrest из "regrest";// Используйте Promiseregrest
  .get("/человек/медведь/свинья")
  // Распечатываем необработанную строку ответа
  .then((ответ) => console.log(ответ.текст))
  // Выводим любую ошибку, если она произошла
  .catch((error) => console.log(`*** Error: ${error}`));// Или используйте новые ключевые слова async/awaitconst getGood = async () => {
  попробуйте {// Сохраните ответ в переменнойconst response = await regrest.get("/foo/bar.json");// распечатайте проанализированный ответ responseconsole.log(response.json);
  } catch (ошибка) {// Вывести любую ошибку, если она произошлаconsole.log(`*** Ошибка: ${error}`);
  }};getGood();// Или используйте обратные вызовы// МЫ ЗДЕСЬ ЭТОГО НЕ ДЕЛАЕМ

Выполнение POST запроса

 сожаление
  .post("/comment", JSON.stringify({ name: "Foo", комментарий: "Bar" }))
  .then((response) => console.log(response.status, response.statusText))
  .catch((ошибка) => console.log(ошибка));

Документация

Удобные методы

regrest.request (варианты)

regrest.get(url[, параметры])

regrest.head(url[, параметры])

regrest.post(url[, данные[, параметры]])

regrest.put(url[, данные[, параметры]])

regrest.delete(url[, параметры])

regrest.options(url[, параметры])

regrest.patch(url[, данные[, параметры]])

Варианты опций

 // Опции по умолчанию отмечены *const options = {
  метод: «GET», // *GET, POST, PUT, DELETE и т. д.
  URL: "https://some-domain.com/api/",
  заголовки: { "Content-Type": "application/json; charset=utf-8" }, // *{}
  параметры: {UID: 9873},
  данные: JSON.stringify(data), // *null
  maxRedirects: 10, // *5
  withCredentials: true, // *false, true};

Атрибуты объекта ответа

 {
  // Содержит код состояния ответа, например 404 для не найденного ресурса, 200 для успеха
  статус: 200,
  // Сообщение, связанное с атрибутом статуса, например ОК для статуса 200
  statusText: «ОК»,
  // Заголовки, которые ответил сервер
  заголовки: {},
  // Содержимое ответа в виде строки
  текст: "",
  // Содержимое ответа в формате JSON
  json: {},
  // Содержимое ответа в виде Blob в браузере и Buffer в Node js
  arrayBuffer: экземпляр Blob || экземпляр Буфера,
  // Содержимое ответа как Blob
  blob: экземпляр Blob};

Обработка ошибок

 regrest.get("/McNullington").catch((ошибка) => {
  if (error.response) {/** * Был сделан запрос, но сервер ответил * с кодом состояния вне диапазона 2XX * `error.response` является экземпляром объекта ответа */console.log(error.response. status);console.log(error.response.statusText);console.log(error.response.headers);// ...
  } else if (error.request) {/** * Запрос был сделан, но ответ не получен * `error.request` — это экземпляр XMLHttpRequest в браузере и экземпляр * http.ClientRequest в Node js */console .log(ошибка.запрос);
  } else {// Произошло что-то ещеconsole.log(error.message);
  }});