Uint8ClampedArray

基线广泛可用

自 2015年7月起，此特性已在主流浏览器中得到支持，可在大多数设备和浏览器版本中正常使用。

Uint8ClampedArray（8 位无符号整型固定数组）类型化数组表示一个由值固定在 0-255 区间的 8 位无符号整型组成的数组；如果你指定一个在 [0,255] 区间外的值，它将被替换为 0 或 255；如果你指定一个非整数，那么它将被设置为最接近它的整数。（数组）内容被初始化为 0。一旦（数组）被创建，你可以使用对象的方法引用数组里的元素，或使用标准的数组索引语法（即使用方括号标记）。

本文内容

语法

new Uint8ClampedArray(length); new Uint8ClampedArray(typedArray); new Uint8ClampedArray(object); new Uint8ClampedArray(buffer [, byteOffset [, length]]);

关于构造函数语法和参数的更多信息，参见 TypedArray。

静态属性

Uint8ClampedArray.BYTES_PER_ELEMENT

返回元素大小的一个数值。对 Uint8ClampedArray 而言是 1。

Uint8ClampedArray.prototype.length

静态长度属性值为 0。对于实际长度（元素的数量），见 Uint8ClampedArray.prototype.length。

Uint8ClampedArray.prototype

原型是 TypedArray（类型化数组）对象。

静态方法

Uint8ClampedArray.from()

从一个类数组或可枚举对象创建一个新的 Uint8ClampedArray。参见 Array.from()。

Uint8ClampedArray.of()

通过一个可选数量参数来创建一个新的 Uint8ClampedArray。参见 Array.of()。

实例属性

还从其父接口 TypedArray 继承实例属性。

Uint8ClampedArray.prototype.constructor

返回创建一个实例原型的函数。这是 Uint8ClampedArray 默认的构造函数。

Uint8ClampedArray.prototype.buffer 只读

返回由 Uint8ClampedArray 引用的 ArrayBuffer 。在创建时所固定下来，因此只能读取。

Uint8ClampedArray.prototype.byteLength 只读

返回从 ArrayBuffer 开始的 Uint8ClampedArray 的（字节的）长度。在创建时所固定下来，因此只能读取。

Uint8ClampedArray.prototype.byteOffset 只读

返回从 ArrayBuffer 开始的 Uint8ClampedArray 的（字节的）偏移。在创建时所固定下来，因此只能读取。

Uint8ClampedArray.prototype.length 只读

返回 UintClamped8Array 具有的元素数量。在创建时所固定下来，因此只能读取。

实例方法

从其父接口 TypedArray 继承实例方法。

示例

创建一个 Uint8ClampedArray 的不同方式：

js
// From a length
var uintc8 = new Uint8ClampedArray(2);
uintc8[0] = 42;
uintc8[1] = 1337;
console.log(uintc8[0]); // 42
console.log(uintc8[1]); // 255 (clamped)
console.log(uintc8.length); // 2
console.log(uintc8.BYTES_PER_ELEMENT); // 1

// From an array
var arr = new Uint8ClampedArray([21, 31]);
console.log(arr[1]); // 31

// From another TypedArray
var x = new Uint8ClampedArray([21, 31]);
var y = new Uint8ClampedArray(x);
console.log(y[0]); // 21

// From an ArrayBuffer
var buffer = new ArrayBuffer(8);
var z = new Uint8ClampedArray(buffer, 1, 4);

// From an iterable
var iterable = (function* () {
  yield* [1, 2, 3];
})();
var uintc8 = new Uint8ClampedArray(iterable);
// Uint8ClampedArray[1, 2, 3]

js
var dv = Uint8ClampedArray([1, 2, 3]);
// TypeError: calling a builtin Uint8ClampedArray constructor
// without new is forbidden

var dv = new Uint8ClampedArray([1, 2, 3]);

参见

帮助改进 MDN

此页面对您有帮助吗？

是否

了解如何参与贡献

此页面最后更新于 2025年10月23日，由 MDN 贡献者更新。

在 GitHub 上查看此页面 • 报告此内容的问题