regrest
v4.0.1
ブラウザおよびnode.js用のMicro PromiseベースのHTTPクライアント
ブラウザから XMLHttpRequest を作成する
Node.jsからhttpリクエストを行う
Promise APIをサポート
組み込みの TypeScript サポート
最新 ✔ | 最新 ✔ | 最新 ✔ | 最新 ✔ | 最新 ✔ | 11 ✔ |
Internet Explorer をサポートする場合は、グローバルPromise
オブジェクトを追加するポリフィルを必ず用意してください。
npm の使用:
$ npm インストールの拒否
cdn の使用:
<script src="https://cdn.jsdelivr.net/npm/regrest/lib/index.umd.min.js"></script>
Regrest は、http 呼び出しを行うための最も簡単な方法になるように設計されています。
GET
リクエストの実行
// NodeJS または CommonJS を使用してインポートします moduleconst regrest = require("regrest").default;// または ES6 を使用して moduleimport regrest from "regrest";// Promiseregrest を使用します .get("/男/熊/豚") // 生の応答文字列を出力します .then((応答) => console.log(応答.テキスト)) // エラーが発生した場合は出力します .catch((error) => console.log(`*** Error: ${error}`));// または、新しい async/await キーワードを使用しますconst getGood = async () => { try {// 応答を変数に保存しますconst response = await regrest.get("/foo/bar.json");// 解析された応答を出力しますconsole.log(response.json); } catch (error) {// エラーが発生した場合は出力console.log(`*** Error: ${error}`); }};getGood();// またはコールバックを使用する// ここではそれを行いません
POST
リクエストの実行
後悔する .post("/comment", JSON.stringify({ 名前: "Foo", コメント: "Bar" })) .then((応答) => console.log(応答.ステータス, 応答.ステータステキスト)) .catch((エラー) => console.log(エラー));
// デフォルトのオプションは *const options = { でマークされています Method: "GET", // *GET、POST、PUT、DELETE など。 URL: "https://some-domain.com/api/", headers: { "Content-Type": "application/json; charset=utf-8" }, // *{} パラメータ: { UID: 9873 }、 データ: JSON.stringify(data), // *null maxRedirects: 10, // *5 withCredentials: true, // *false, true};
{ // 応答のステータス コードが含まれます。例: リソースが見つからない場合は 404、成功した場合は 200 ステータス: 200、 // ステータス属性に関連するメッセージ。たとえば、ステータス 200 の場合は OK ステータステキスト: "OK", // サーバーが応答したヘッダー ヘッダー: {}、 // 応答内容を文字列として返す 文章: ""、 // 応答内容を JSON として返す json: {}、 // ブラウザー上の Blob およびノード js 上のバッファーとしての応答コンテンツ arrayBuffer: BLOB のインスタンス ||バッファのインスタンス、 // コンテンツを BLOB として応答します blob: BLOB のインスタンス};
regrest.get("/マクナリントン").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 のインスタンスであり、 * Node js 上の http.ClientRequest */console のインスタンスです.log(エラー.リクエスト); } else {// 他に何かが発生しましたconsole.log(error.message); }});