HTTP Status パッケージ

このパッケージは、さまざまな HTTP ステータスコードを表す静的プロパティを持つシンプルな JavaScript/TypeScript クラス HTTPStatus を提供します。

インストール

npm でパッケージをインストールできます。

npm install swn-http-status

[!TIP] TypeScript プロジェクトでは型定義ファイル（.d.ts）も自動的に利用されます。

使い方

TypeScript の場合

import HTTPStatus from "swn-http-status";

console.log(HTTPStatus.OK); // 200
console.log(HTTPStatus.NotFound); // 404

JavaScript (ESModules) の場合

// ES Modules
import HTTPStatus from "swn-http-status";

console.log(HTTPStatus.OK); // 200
console.log(HTTPStatus.NotFound); // 404

JavaScript の場合 (CommonJS)

// CommonJS
const HTTPStatus = require("swn-http-status");

console.log(HTTPStatus.OK); // 200
console.log(HTTPStatus.NotFound); // 404

[!NOTE] CommonJS で利用する場合も require("swn-http-status") で直接 HTTPStatus.OK のようにアクセスできます。

HTTP ステータスコード一覧

HTTPStatus クラスには、以下のステータスコードが含まれています。

コード	名前	説明
100	Continue	サーバーはリクエストヘッダーを受信し、クライアントはリクエストを続行できます。
101	SwitchingProtocols	サーバーがプロトコルの切り替えを承認したことを示します。
102	Processing	WebDAV 拡張。リクエストの処理が継続中であることを示します。
103	EarlyHints	レスポンスヘッダーの早期通知に使用されます。
200	OK	リクエストが正常に成功しました。
201	Created	新しいリソースが作成されました。
202	Accepted	リクエストは受理されましたが、まだ処理されていません。
203	NonAuthoritativeInformation	オリジンサーバー以外からの情報を返します。
204	NoContent	レスポンスボディがありません。
205	ResetContent	クライアントはフォームなどをリセットする必要があります。
206	PartialContent	部分的なレスポンスを返します（範囲リクエスト）。
207	MultiStatus	WebDAV 拡張。複数のステータスを返します。
208	AlreadyReported	WebDAV 拡張。すでに報告済みのリソースです。
226	IMUsed	インスタントメッセージングで使用される拡張コードです。
300	MultipleChoices	複数の選択肢が存在します。
301	MovedPermanently	リソースが恒久的に移動しました。
302	Found	リソースが一時的に移動しました。
303	SeeOther	他の URI を参照してください。
304	NotModified	リソースは変更されていません。
305	UseProxy	プロキシを使用する必要があります。
307	TemporaryRedirect	一時的にリダイレクトされます。
308	PermanentRedirect	恒久的にリダイレクトされます。
400	BadRequest	サーバーがリクエストを理解できません。不正な構文やパラメータの場合に返されます。
401	Unauthorized	認証が必要ですが、認証情報が提供されていないか無効です。
402	PaymentRequired	支払いが必要な場合に使用されます（現在は予約されています）。
403	Forbidden	サーバーがリクエストを理解したが、権限がないため拒否されました。
404	NotFound	サーバーは要求されたリソースを見つけることができません。ブラウザでは、これは URL が認識されないことを意味します。
405	MethodNotAllowed	リクエストメソッドがサポートされていません。
406	NotAcceptable	リクエストしたリソースが Accept ヘッダーで許可されていません。
407	ProxyAuthenticationRequired	プロキシ認証が必要です。
408	RequestTimeout	サーバーがクライアントからのリクエストをタイムアウトしました。
409	Conflict	リクエストが現在のリソースの状態と競合しています。
410	Gone	リクエストされたリソースは恒久的に削除されました。
411	LengthRequired	Content-Length ヘッダーが必要です。
412	PreconditionFailed	前提条件が失敗しました。
413	PayloadTooLarge	リクエストペイロードが大きすぎます。
414	URITooLong	リクエスト URI が長すぎます。
415	UnsupportedMediaType	サポートされていないメディアタイプです。
416	RangeNotSatisfiable	リクエストした範囲が満たせません。
417	ExpectationFailed	Expect ヘッダーで指定された期待値にサーバーが応えられません。
418	ImATeapot	エイプリルフールのジョークコードです。ティーポットはコーヒーを淹れられません。
421	MisdirectedRequest	リクエストが誤ったサーバーに送信されました。
422	UnprocessableEntity	リクエストは理解できたが処理できません（バリデーションエラー等）。
423	Locked	リソースがロックされています。
424	FailedDependency	依存関係の失敗によりリクエストが失敗しました。
425	TooEarly	リクエストが早すぎます。
426	UpgradeRequired	プロトコルのアップグレードが必要です。
428	PreconditionRequired	前提条件が必要です。
429	TooManyRequests	リクエストが多すぎます（レートリミット）。
431	RequestHeaderFieldsTooLarge	リクエストヘッダーが大きすぎます。
451	UnavailableForLegalReasons	法的理由により利用できません。
500	InternalServerError	サーバー内部で予期しないエラーが発生しました。
501	NotImplemented	サーバーがリクエストされた機能を実装していません。
502	BadGateway	サーバーが不正なレスポンスを受け取りました。
503	ServiceUnavailable	サービスが一時的に利用できません。
504	GatewayTimeout	ゲートウェイまたはプロキシがタイムアウトしました。
505	HTTPVersionNotSupported	サーバーがリクエストされた HTTP バージョンをサポートしていません。
506	VariantAlsoNegotiates	ネゴシエーションエラーが発生しました。
507	InsufficientStorage	サーバーのストレージ容量が不足しています。
508	LoopDetected	サーバーが無限ループを検出しました。
510	NotExtended	拡張が必要です。
511	NetworkAuthenticationRequired	ネットワーク認証が必要です。

更新履歴

バージョン	日付	主な変更点
1.0.5	2025-06-10	HTTP ステータスコードから名前を取得できる `HTTPStatus.Name(statusCode: number): string \`	undefined 静的メソッドを追加全コード・全名称の相互変換テストを追加
1.0.4	2025-05-23	CommonJS での利用方法を `HTTPStatus.default.OK` から `HTTPStatus.OK` へ変更
1.0.3	2025-05-23	ESModule 対応関連の修正を行いました
1.0.2	2025-05-23	ビルド成果物の配置と npm scripts を整理し、ESModule と CommonJS 両対応をより明確に `dist/src/` 配下に ESM・CJS 両方のエントリポイントを配置 `package.json` の `exports` 設定を修正
1.0.1	2025-05-22	README の「使い方」で、ESModules と CommonJS の場合を分けて記載
1.0.0	2025-05-21	初回リリース

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルをご覧ください。

パッケージの詳細

swn-http-status

readme