getStatus / status

HTTP 状态码 ↔ 状态消息的对照表，加上一个双向查询的 getStatus 辅助函数。数据和 Node 自带的 http.STATUS_CODES 完全一致，只是打包成了浏览器也能用的形式。

使用

import { getStatus, status } from 'ranuts/utils';

getStatus(404); // 'Not Found'
getStatus('404'); // 'Not Found' —— 数字字符串会先被当作状态码解析
getStatus('not found'); // 404 —— 解析失败后回退到按消息查找，不区分大小写

status.redirect[302]; // true
status.empty[204]; // true
status.retry[503]; // true

API

`getStatus(code)`

参数

参数	说明	类型	默认值
`code`	状态码、数字字符串，或状态消息	`number \| string`	必填

number | string：传入 number 返回消息；传入 string 返回状态码（像 '404' 这样的数字字符串会先被当作状态码解析，只有解析不出已知状态码时才回退到按消息查找）。输入既不是已知状态码也不是已知消息时会抛出异常。

`status`

字段	说明	类型
`message`	状态码 → 消息	`Map<number, string>`
`code`	小写消息 → 状态码	`Map<string, number>`
`codes`	所有已知状态码	`number[]`
`redirect`	属于重定向的状态码（`300`、`301`、`302`、`303`、`305`、`307`、`308`）	`Record<number, true>`
`empty`	不带响应体的状态码（`204`、`205`、`304`）	`Record<number, true>`
`retry`	值得重试的状态码（`502`、`503`、`504`）	`Record<number, true>`

注意事项

getStatus 在状态码/消息未知时会抛出异常：参数既不是 number 也不是 string 时抛 TypeError，其他未知情况抛普通 Error。如果输入不能保证一定合法（比如从网络上读到的状态码），用 try/catch 包一下，或者先检查 status.codes.includes(n)。
status.redirect / empty / retry 是普通对象，不是 Set：判断是否命中要用 status.retry[code]，不是 .has()。
浏览器和 Node 都能跑（ranuts/utils），所以客户端也能用它做和服务端 ranuts/node 一样的状态码↔消息映射。