Espruino:Справочник по API/Библиотека http/request()

Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску

Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.


Функция http.request()[1]

Синтаксис

require("http").request(options, callback)

Параметры

  • options – объект, содержащий поля host,port,path,method,headers (а также ca,key,cert, если включен HTTPS)
  • callback – функция обратного вызова, которая будет вызвана при создании соединения. Для обработки ответа затем можно вызвать res.on('data', function(data) { ... }) и res.on('close', function() { ... }).

Возвращаемое значение

Новый объект httpCRq.

Описание

Создает HTTP-запрос. В конце на этой функции нужно вызвать end(), чтобы завершить ее выполнение. Объект options имеет следующий формат:

var options = {
    host: 'example.com', // название хоста
    port: 80,            // порт (опционально), по умолчанию 80
    path: '/',           // путь, отправляемый серверу
    method: 'GET',       // HTTP-команда, отправляемая серверу
                         // (должна состоять из заглавных букв;
                         // например, 'GET', 'POST' и т.д.)
    protocol: 'http:',   // протокол (опционально): https: или http:
    headers: { key : value, key : value } // HTTP-заголовки
                                          // (опционально)
  };
var req = require("http").request(options, function(res) {
  res.on('data', function(data) {
    console.log("HTTP> "+data);
  });
  res.on('close', function(data) {
    console.log("Соединение закрыто ");
  });
});
// если вашему запросу нужны данные для отправки,
// здесь можно вписать req.write(...).
req.end(); // вызывается, чтобы завершить HTTP-запрос и получить ответ

Максимально быстро и просто заполнить options из URL можно вот так:

var options = url.parse("http://www.example.com/foo.html")
Примечание

Если включен TLS/HTTPS, в объекте options также могут быть поля ca, key и cert. Более подробно о них и о том, как их использовать, читайте в описании функции tls.connect().

Примеры

См.также

Внешние ссылки