HTTP在客户端和服务器上提供HTTP请求API。 要使用这些函数,通过在终端中运行将HTTP包添加到您的项目中:
要使用的HTTP方法,如“GET”,“POST”或“HEAD”。
要检索的URL。
可选的回调。 如果通过,方法异步运行,而不是同步,并调用asyncCallback。 在客户端,这个回调是必需的。
用作HTTP请求主体的字符串。
JSON能够将对象串化并用作HTTP请求体。 覆盖内容。
查询字符串以进入URL。 覆盖url中的任何查询字符串。
要编码的请求参数字典,并放置在URL(对于GET)或请求体(对于POST)中。 如果指定了内容或数据,则参数将始终放在URL中。
表单“用户名:密码”的HTTP基本认证字符串
字符串字典,标题添加到HTTP请求。
在失败前等待请求的最长时间(以毫秒为单位)。 默认情况下没有超时。
如果为true,则透明地遵循HTTP重定向。 不能在客户端设置为false。 默认为true。
在服务器上,HTTP.call通过使用npm请求模块来实现。 此对象中的任何选项都将直接传递给请求调用。
在客户端上,在发送请求之前调用它,以允许更直接地操作底层的XMLHttpRequest对象,该对象将作为第一个参数传递。 如果回调返回false,请求将不会被发送。
这个函数启动一个到远程服务器的HTTP请求。
在服务器上,这个函数可以同步运行,也可以异步运行。 如果回调被忽略,它将同步运行,并且一旦请求成功完成,结果就会返回。 如果请求不成功,则会抛出错误。 从Meteor方法中进行服务器到服务器的HTTP API调用时,这是非常有用的,因为该方法可以基于同步HTTP调用的结果成功或失败。 在这种情况下,考虑使用this.unblock()来允许同一连接上的其他方法同时运行。
在客户端上,这个函数必须通过传递回调来异步使用。 请注意,有些浏览器在发送请求之前首先发送OPTIONS请求(以确定CORS
头)。
支持HTTP和HTTPS协议。 url参数必须是绝对URL,包括服务器上的协议和主机名,但可能与客户机上的当前主机相关。 查询选项替换url的查询字符串。 放在URL中的params中指定的参数将附加到任何查询字符串。 例如,使用“/ path?query”的url和{foo:'bar'}的参数,最终的URL将是'/ path?query&foo = bar'。
参数被放入URL或请求体中,具体取决于请求的类型。 如果请求没有正文,比如GET和HEAD,那么这些参数将始终放在URL中。 对于POST或其他类型的请求,参数将被编码到具有标准的x-www-form-urlencoded内容类型的主体中,除非内容或数据选项用于指定主体,在这种情况下参数将是 附加到URL。
当以异步模式运行时,回调会收到两个参数,错误和结果。 如果请求以任何方式失败,包括400或500范围内的网络错误,超时或HTTP状态码,则错误参数将包含错误。 在4xx / 5xx HTTP状态码的情况下,错误时的响应属性与结果对象的内容相匹配。 在同步模式下运行时,从函数返回结果,或者抛出错误。
数字HTTP结果状态码,错误时为null。
作为字符串的HTTP响应的主体。
如果响应标头指示JSON内容,则包含解析为JSON对象的文档正文.
来自响应的HTTP标头字典。
发送HTTP GET请求。等同于使用“GET”作为第一个参数来调用HTTP.call。
请求发送到的URL。
选项传递给HTTP.call。
请求完成时调用的回调。 客户端需要。
网友评论