此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

TypedArray.prototype.includes()

基线 广泛可用

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

includes() 方法判断类型化数组中是否含有特定元素,并相应返回 true 或者 false,这个方法的算法和 Array.prototype.includes() 相同。TypedArray 是这里的类型化数组类型之一。

语法

js
includes(searchElement)
includes(searchElement, fromIndex)

参数

searchElement

要搜索的元素。

fromIndex

可选,数组中的位置,在这里开始搜索 searchElement;默认为 0。

返回值

Boolean

示例

js
var uint8 = new Uint8Array([1, 2, 3]);
uint8.includes(2); // true
uint8.includes(4); // false
uint8.includes(3, 3); // false

// NaN 的处理(仅仅对 Float32 和 Float64 为 true)
new Uint8Array([NaN]).includes(NaN); // false,因为 NaN 传递给构造器时转换为 0
new Float32Array([NaN]).includes(NaN); // true;
new Float64Array([NaN]).includes(NaN); // true;

规范

规范
ECMAScript® 2027 Language Specification
# sec-%typedarray%.prototype.includes

浏览器兼容性

参见