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

GPUDevice: createBuffer() method

· 52CE 我爱测

The **`createBuffer()`** method of the GPUDevice interface creates a GPUBuffer in which to store raw data to use in GPU operations.

WebGPU API

The createBuffer() method of the GPUDevice interface creates a GPUBuffer in which to store raw data to use in GPU operations.

Syntax

createBuffer(descriptor)

Parameters

  • descriptor
    • : An object containing the following properties:
      • label

        • : A string providing a label that can be used to identify the object, for example in GPUError messages or console warnings.
      • mappedAtCreation

        • : A boolean. If set to true, the buffer will be mapped upon creation, meaning that you can set the values inside the buffer immediately by calling GPUBuffer.getMappedRange(). The default value is false.

          Note that it is valid to set mappedAtCreation: true so you can set the buffer's initial data, even if the GPUBufferUsage.MAP_READ or GPUBufferUsage.MAP_WRITE usage flags are not set.

      • size

        • : A number representing the size of the buffer, in bytes. If mappedAtCreation is set to true, this must be a multiple of 4.
      • usage

        • : The Bitwise flags representing the allowed usages for the GPUBuffer. The possible values are in the GPUBuffer.usage value table.

          Note that multiple possible usages can be specified by separating values with bitwise OR, for example: GPUBufferUsage.COPY_SRC | GPUBufferUsage.MAP_WRITE.

Return value

A GPUBuffer object instance.

Exceptions

  • RangeError
    • : Thrown if mappedAtCreation is set to true, and the specified size is not a multiple of 4.

Validation

The following criteria must be met when calling createBuffer(), otherwise a GPUValidationError is generated and an invalid GPUBuffer object is returned:

  • A valid usage is specified.
  • GPUBufferUsage.MAP_READ is specified, and no additional flags are specified other than GPUBufferUsage.COPY_DST.
  • GPUBufferUsage.MAP_WRITE is specified, and no additional flags are specified other than GPUBufferUsage.COPY_SRC.

[!NOTE] If the buffer allocation fails without any specific side-effects, a GPUOutOfMemoryError object is generated.

Examples

In our basic compute demo, we create an output buffer to read GPU calculations to, and a staging buffer to be mapped for JavaScript access.

const output = device.createBuffer({
  size: BUFFER_SIZE,
  usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC,
});

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

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

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

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