大网数据广告活动
Web 标准与前端开发

GPUBuffer: mapState property

· 52CE 我爱测

The **`mapState`** read-only property of the GPUBuffer interface represents the mapped state of the `GPUBuffer`.

WebGPU API

The mapState read-only property of the GPUBuffer interface represents the mapped state of the GPUBuffer.

Value

An enumerated value. Possible values are:

  • unmapped
    • : The buffer is not mapped. GPUBuffer.getMappedRange() cannot be used to access the contents of the GPUBuffer in JavaScript. This could be because:
      • GPUBuffer.mapAsync() has not yet been called.
      • The GPUBuffer was previously mapped, and then unmapped again with GPUBuffer.unmap().
  • pending
    • : The buffer is not yet mapped. GPUBuffer.mapAsync() has been called, but its Promise is currently pending. GPUBuffer.getMappedRange() cannot currently be used to access the contents of the GPUBuffer in JavaScript.
  • mapped
    • : The buffer is mapped. The GPUBuffer.mapAsync() Promise has fulfilled, and GPUBuffer.getMappedRange() can now be used to access the contents of the GPUBuffer in JavaScript.

Examples

const stagingBuffer = device.createBuffer({
  size: BUFFER_SIZE,
  usage: GPUBufferUsage.MAP_READ | GPUBufferUsage.COPY_DST,
});

console.log(stagingBuffer.mapState); // "unmapped"

// …

await stagingBuffer.mapAsync(
  GPUMapMode.READ,
  0, // Offset
  BUFFER_SIZE, // Length
);

console.log(stagingBuffer.mapState); // "mapped"

Specifications

Browser compatibility

See also

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。