GPUTexture: depthOrArrayLayers property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Web Workers.

The depthOrArrayLayers read-only property of the GPUTexture interface represents the depth or layer count of the GPUTexture.

This is set based on the size property in the descriptor object passed into the originating GPUDevice.createTexture() call.

Value

A number. This represents:

The depth in pixels, in the case of textures with a "3d" GPUTexture.dimension.
The number of layers, in the case of layered textures with a "2d" GPUTexture.dimension.

In cases where the GPUTexture does not have a depth or layers, the value is 1.

Examples

js
// …

const test = device.createTexture({
  size: [128],
  format: "r8uint",
  dimension: "1d",
  usage: GPUTextureUsage.COPY_SRC,
});

console.log(test.depthOrArrayLayers); // 1