Espruino:Справочник по API/Библиотека http/request(): различия между версиями
Материал из Онлайн справочника
Перейти к навигацииПерейти к поиску
Myagkij (обсуждение | вклад) (Новая страница: «{{Espruino/Панель перехода}} {{Перевод от Сubewriter}} {{Myagkij-редактор}} =<ref>[ www.espruino.com - ]</ref>= ==Синтакс...») |
Myagkij (обсуждение | вклад) Нет описания правки |
||
| Строка 3: | Строка 3: | ||
{{Myagkij-редактор}} | {{Myagkij-редактор}} | ||
=<ref>[ www.espruino.com - ]</ref>= | =Функция http.request()<ref>[https://www.espruino.com/Reference#t_l_http_request www.espruino.com - http.request]</ref>= | ||
==Синтаксис== | ==Синтаксис== | ||
<syntaxhighlight lang="javascript" enclose="div"> | <syntaxhighlight lang="javascript" enclose="div"> | ||
require("http").request(options, callback) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==Параметры== | ==Параметры== | ||
* '''options''' – объект, содержащий поля host,port,path,method,headers (а также ca,key,cert, если включен HTTPS) | |||
* '''callback''' – функция обратного вызова, которая будет вызвана при создании соединения. Для обработки ответа затем можно вызвать res.on('data', function(data) { ... }) и res.on('close', function() { ... }). | |||
==Возвращаемое значение== | |||
== | Новый объект httpCRq. | ||
==Описание== | |||
Создает HTTP-запрос. В конце на этой функции нужно вызвать end(), чтобы завершить ее выполнение. Объект options имеет следующий формат: | |||
<syntaxhighlight lang="javascript" enclose="div"> | |||
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-запрос и получить ответ | |||
</syntaxhighlight> | |||
Максимально быстро и просто заполнить options из URL можно вот так: | |||
<syntaxhighlight lang="javascript" enclose="div"> | |||
var options = url.parse("http://www.example.com/foo.html") | |||
</syntaxhighlight> | |||
'''Примечание:''' Если включен [[TLS]]/[[HTTPS]], в объекте ''options'' также могут быть поля ''ca, key и cert''. Более подробно о них и о том, как их использовать, читайте в описании функции [https://www.espruino.com/Reference#l_tls_connect tls.connect()]. | |||
== Примеры == | == Примеры == | ||
Версия от 21:01, 27 декабря 2020
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Функция 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().
Примеры
См.также
Внешние ссылки
