HTTP在客戶端和服務(wù)器上提供HTTP請求API郑趁。 要使用這些函數(shù)丛塌,通過在終端中運行將HTTP包添加到您的項目中:
要使用的HTTP方法喧笔,如“GET”避矢,“POST”或“HEAD”悼瘾。
要檢索的URL囊榜。
可選的回調(diào)。 如果通過亥宿,方法異步運行卸勺,而不是同步,并調(diào)用asyncCallback烫扼。 在客戶端曙求,這個回調(diào)是必需的。
用作HTTP請求主體的字符串映企。
JSON能夠?qū)ο蟠⒂米鱄TTP請求體悟狱。 覆蓋內(nèi)容。
查詢字符串以進入URL堰氓。 覆蓋url中的任何查詢字符串挤渐。
要編碼的請求參數(shù)字典,并放置在URL(對于GET)或請求體(對于POST)中双絮。 如果指定了內(nèi)容或數(shù)據(jù)浴麻,則參數(shù)將始終放在URL中。
表單“用戶名:密碼”的HTTP基本認證字符串
字符串字典囤攀,標(biāo)題添加到HTTP請求软免。
在失敗前等待請求的最長時間(以毫秒為單位)。 默認情況下沒有超時抚岗。
如果為true或杠,則透明地遵循HTTP重定向。 不能在客戶端設(shè)置為false宣蔚。 默認為true向抢。
在服務(wù)器上,HTTP.call通過使用npm請求模塊來實現(xiàn)胚委。 此對象中的任何選項都將直接傳遞給請求調(diào)用挟鸠。
在客戶端上,在發(fā)送請求之前調(diào)用它亩冬,以允許更直接地操作底層的XMLHttpRequest對象艘希,該對象將作為第一個參數(shù)傳遞硅急。 如果回調(diào)返回false,請求將不會被發(fā)送营袜。
這個函數(shù)啟動一個到遠程服務(wù)器的HTTP請求。
在服務(wù)器上荚板,這個函數(shù)可以同步運行吩屹,也可以異步運行拧抖。 如果回調(diào)被忽略,它將同步運行唧席,并且一旦請求成功完成,結(jié)果就會返回袱吆。 如果請求不成功,則會拋出錯誤绞绒。 從Meteor方法中進行服務(wù)器到服務(wù)器的HTTP API調(diào)用時,這是非常有用的蓬衡,因為該方法可以基于同步HTTP調(diào)用的結(jié)果成功或失敗。 在這種情況下狰晚,考慮使用this.unblock()來允許同一連接上的其他方法同時運行。
在客戶端上瓷们,這個函數(shù)必須通過傳遞回調(diào)來異步使用。 請注意秒咐,有些瀏覽器在發(fā)送請求之前首先發(fā)送OPTIONS請求(以確定CORS
頭)谬晕。
支持HTTP和HTTPS協(xié)議。?url參數(shù)必須是絕對URL携取,包括服務(wù)器上的協(xié)議和主機名攒钳,但可能與客戶機上的當(dāng)前主機相關(guān)。 查詢選項替換url的查詢字符串雷滋。 放在URL中的params中指定的參數(shù)將附加到任何查詢字符串不撑。 例如,使用“/ path晤斩?query”的url和{foo:'bar'}的參數(shù)焕檬,最終的URL將是'/ path?query&foo = bar'澳泵。
參數(shù)被放入URL或請求體中实愚,具體取決于請求的類型。 如果請求沒有正文,比如GET和HEAD爆侣,那么這些參數(shù)將始終放在URL中。 對于POST或其他類型的請求幢妄,參數(shù)將被編碼到具有標(biāo)準(zhǔn)的x-www-form-urlencoded內(nèi)容類型的主體中兔仰,除非內(nèi)容或數(shù)據(jù)選項用于指定主體,在這種情況下參數(shù)將是 附加到URL蕉鸳。
當(dāng)以異步模式運行時乎赴,回調(diào)會收到兩個參數(shù),錯誤和結(jié)果潮尝。 如果請求以任何方式失敗榕吼,包括400或500范圍內(nèi)的網(wǎng)絡(luò)錯誤,超時或HTTP狀態(tài)碼勉失,則錯誤參數(shù)將包含錯誤羹蚣。 在4xx / 5xx HTTP狀態(tài)碼的情況下,錯誤時的響應(yīng)屬性與結(jié)果對象的內(nèi)容相匹配乱凿。 在同步模式下運行時顽素,從函數(shù)返回結(jié)果,或者拋出錯誤徒蟆。
數(shù)字HTTP結(jié)果狀態(tài)碼胁出,錯誤時為null。
作為字符串的HTTP響應(yīng)的主體段审。
如果響應(yīng)標(biāo)頭指示JSON內(nèi)容全蝶,則包含解析為JSON對象的文檔正文.
來自響應(yīng)的HTTP標(biāo)頭字典。
發(fā)送HTTP GET請求丈冬。等同于使用“GET”作為第一個參數(shù)來調(diào)用HTTP.call埂蕊。
請求發(fā)送到的URL蓄氧。
選項傳遞給HTTP.call喉童。
請求完成時調(diào)用的回調(diào)堂氯。 客戶端需要。