Response: bytes() 方法

基准线 2025
新推出

自 ⁨2025 年 1 月⁩ 起,此功能在最新的设备和浏览器版本中均可正常工作。此功能可能无法在旧设备或浏览器中工作。

注意:此功能在 Web Workers 中可用。

Response 接口的 bytes() 方法会读取一个 Response 流直到完成。它返回一个解析为 Uint8Array 的 Promise。

语法

js
bytes()

参数

无。

返回值

解析为 Uint8Array 的 Promise。

异常

AbortError DOMException

请求已被 中止

TypeError

因以下原因之一而抛出:

RangeError

创建关联的 ArrayBuffer 时出现问题。例如,如果数据大小超过 Number.MAX_SAFE_INTEGER

示例

获取和解码文件

以下代码展示了如何获取一个文本文件,将其正文作为 Uint8Array 返回,然后将其解码为字符串。

js
const response = await fetch("https://www.example.com/textfile.txt");
const textFile = await response.bytes();
const string = new TextDecoder().decode(textFile);
console.log(string);

获取图片文件签名

此示例演示了如何使用 bytes() 读取多个图片文件的签名字节,并识别其类型。

HTML

首先,我们定义一个 <select> 元素用于选择文件类型,并附带指示 WikiMedia commons 上特定文件的相应值,以便获取。

html
<label for="file-select">Choose a file:</label>

<select name="Files" id="file-select">
  <option value="">--Select an image type--</option>
  <option
    value="https://upload.wikimedia.org/wikipedia/commons/7/70/Example.png">
    PNG
  </option>
  <option
    value="https://upload.wikimedia.org/wikipedia/commons/a/a9/Example.jpg">
    JPG
  </option>
  <option
    value="https://upload.wikimedia.org/wikipedia/commons/8/8f/Example.gif">
    GIF89a
  </option>
</select>

JavaScript

代码首先检查是否支持 bytes() 方法。如果支持该方法,则为 <select> 元素添加一个 change 事件 的事件处理程序。当值更改时,它会将所选内容的值(图片文件的 URL)传递给下面定义的 checkSignature() 方法。如果不支持该方法,则会记录此信息。

js
if ("bytes" in Response.prototype) {
  const selectFileElement = document.getElementById("file-select");
  selectFileElement.addEventListener("change", (event) => {
    try {
      checkSignature(event.target.value);
    } catch (e) {
      log(e);
    }
  });
} else {
  log("Response.bytes() not supported");
}

下面定义了 checkSignature() 方法。它会获取给定 url 处的文件的内容,并使用 response.bytes() 将其作为字节数组获取。然后将初始字节与常见文件类型的初始签名字节进行比较。最后记录文件名和文件类型。

js
async function checkSignature(url) {
  if (url === "") return;
  log(`File: ${url}`);
  const response = await fetch(url);
  const image = await response.bytes();

  // File signatures from: https://en.wikipedia.org/wiki/List_of_file_signatures
  const jpgSignature = [0xff, 0xd8, 0xff, 0xe0];
  const pngSignature = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
  const gif89aSignature = [0x47, 0x49, 0x46, 0x38, 0x39, 0x61];

  if (
    image
      .slice(0, jpgSignature.length)
      .every((byte, index) => byte === jpgSignature[index])
  ) {
    log(`JPG signature: FF D8 FF E0`);
  } else if (
    image
      .slice(0, pngSignature.length)
      .every((byte, index) => byte === pngSignature[index])
  ) {
    log(`PNG signature: 89 50 4E 47 0D 0A 1A 0A`);
  } else if (
    image
      .slice(0, gif89aSignature.length)
      .every((byte, index) => byte === gif89aSignature[index])
  ) {
    log(`GIF (GIF89a) signature: 47 49 46 38 39 61`);
  } else {
    log("Unknown format");
  }
}

结果

使用选择列表选择一个图片类型。日志随后应显示文件名以及根据文件签名确定的文件类型。

规范

规范
Fetch
# dom-body-bytes

浏览器兼容性

另见