Uint8ClampedArray

基线广泛可用

此功能已很成熟，并在许多设备和浏览器版本中运行。自以下日期起，它已在各浏览器中提供 2015 年 7 月.

Uint8ClampedArray 类型化数组表示一个 8 位无符号整数数组，这些整数被钳制到 0-255。内容初始化为 0，除非显式提供初始化数据。一旦建立，您可以使用对象的方法或使用标准数组索引语法（即使用方括号表示法）来引用数组中的元素。

Uint8ClampedArray 是隐藏的 TypedArray 类的子类。

构造函数

Uint8ClampedArray(): 创建一个新的 Uint8ClampedArray 对象。

静态属性

还从其父类 TypedArray 继承静态属性.

Uint8ClampedArray.BYTES_PER_ELEMENT: 返回元素大小的数字值。对于 Uint8ClampedArray，值为 1。

静态方法

从其父类 TypedArray 继承静态方法.

实例属性

还从其父类 TypedArray 继承实例属性.

这些属性在 Uint8ClampedArray.prototype 上定义，并由所有 Uint8ClampedArray 实例共享。

Uint8ClampedArray.prototype.BYTES_PER_ELEMENT: 返回元素大小的数字值。对于 Uint8ClampedArray，值为 1。
Uint8ClampedArray.prototype.constructor: 创建实例对象的构造函数。对于 Uint8ClampedArray 实例，初始值为 Uint8ClampedArray 构造函数。

实例方法

从其父类 TypedArray 继承实例方法.

示例

创建 Uint8ClampedArray 的不同方法

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

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

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

// From an ArrayBuffer
const buffer = new ArrayBuffer(8);
const z = new Uint8ClampedArray(buffer, 1, 4);
console.log(z.byteOffset); // 1

// From an iterable
const iterable = (function* () {
  yield* [1, 2, 3];
})();
const uint8cFromIterable = new Uint8ClampedArray(iterable);
console.log(uint8cFromIterable);
// Uint8ClampedArray [1, 2, 3]

规范

规范
ECMAScript 语言规范 # 表格-49

浏览器兼容性

BCD 表格仅在浏览器中加载