This is documentation for the next SDK version. For up-to-date documentation, see the latest version (SDK 55).

For the complete documentation index, see llms.txt. Use this Use this file to discover all available pages.

expo-blob 为 React Native 提供了符合 Web 标准的 Blob 实现，具有更优的性能，并且能在所有平台上一致工作。与 react-native 导出的实现相比，它更加可靠；不同于 react-native 中的 Blob，它在 slice() 方法和其他 Web API 功能方面存在限制。

安装

If you are installing this in an existing React Native app, make sure to install expo in your project.

用法

基本 Blob 创建

import { Blob } from 'expo-blob';

// 创建一个空的 blob
const emptyBlob = new Blob();

// 从文本创建一个 blob
const textBlob = new Blob(['Hello, World!'], { type: 'text/plain' });

// 从二进制数据创建一个 blob
const binaryBlob = new Blob([new Uint8Array([1, 2, 3, 4])], {
  type: 'application/octet-stream',
});

// 从混合内容创建一个 blob
const mixedBlob = new Blob(
  [
    '文本内容',
    new Uint8Array([65, 66, 67]), // ASCII 中的 ABC
    '更多文本',
  ],
  { type: 'text/plain' }
);

Blob 属性

const blob = new Blob(['Hello, World!'], { type: 'text/plain' });

console.log(blob.size); // 13（字节）
console.log(blob.type); // "text/plain"

读取 blob 内容

const blob = new Blob(['Hello, World!'], { type: 'text/plain' });

// 读取为文本
const text = await blob.text();
console.log(text); // "Hello, World!"

// 读取为字节
const bytes = await blob.bytes();
console.log(bytes); // Uint8Array(13) [72, 101, 108, 108, 111, 44, 32, 87, 111, 114, 108, 100, 33]

// 读取为 ArrayBuffer
const arrayBuffer = await blob.arrayBuffer();
console.log(arrayBuffer); // ArrayBuffer(13)

对 blob 进行切片

const blob = new Blob(['Hello, World!'], { type: 'text/plain' });

// 从位置 0 切到 5
const slice1 = blob.slice(0, 5);
console.log(await slice1.text()); // "Hello"

// 从位置 7 切到末尾
const slice2 = blob.slice(7);
console.log(await slice2.text()); // "World!"

// 使用自定义类型进行切片
const slice3 = blob.slice(0, 5, 'text/html');
console.log(slice3.type); // "text/html"

流式传输

const blob = new Blob(['Large content...'], { type: 'text/plain' });

// 创建一个可读流
const stream = blob.stream();
const reader = stream.getReader();

// 读取块
while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  console.log('Chunk:', value);
}

API

Classes

Types