From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../global_objects/array/observe/index.html | 92 ++++++++++++++++++++++ 1 file changed, 92 insertions(+) create mode 100644 files/zh-cn/web/javascript/reference/global_objects/array/observe/index.html (limited to 'files/zh-cn/web/javascript/reference/global_objects/array/observe') diff --git a/files/zh-cn/web/javascript/reference/global_objects/array/observe/index.html b/files/zh-cn/web/javascript/reference/global_objects/array/observe/index.html new file mode 100644 index 0000000000..7c2dcc8474 --- /dev/null +++ b/files/zh-cn/web/javascript/reference/global_objects/array/observe/index.html @@ -0,0 +1,92 @@ +--- +title: Array.observe() +slug: Web/JavaScript/Reference/Global_Objects/Array/observe +tags: + - JavaScript + - 实验性 + - 数组 + - 方法 + - 过时的 +translation_of: Archive/Web/JavaScript/Array.observe +--- +
{{JSRef}}{{obsolete_header}}
+ +

Array.observe() 方法用于异步监视数组发生的变化，类似于针对对象的 {{jsxref("Object.observe()")}} 。当数组的值发生变化时，它按发生顺序提供了一个变化流。与 Object.observe() 类似，它由如下可接受的变化类型列表["add"、"update"、"delete"、"splice"]触发。

+ +

语法

+ +
Array.observe(arr, callback)
+ +

参数

+ +
+
arr
+
用于被监视的数组
+
callback
+
每当数组发生变化时，使用如下参数调用该函数： +
+
changes
+
用于表示变化的对象数组。每个变化对象的属性如下： +
    +
  • name: 变化的属性名。
    • +
  • object: 变化后的数组。
    • +
  • type: 用于表示变化类型的字符串。其取值为"add"、"update"、"delete"或 "splice"之一。
    • +
  • oldValue: 仅用于"update"和"delete"类型。变化之前的取值。
    • +
  • index: 仅用于"splice"类型。变化发生所在索引。
    • +
  • removed: 仅用于"splice"类型。被删除元素组成的数组。
    • +
  • addedCount: 仅用于"splice"类型。被添加的元素数量。
    • +
+
+
+
+
+ +

描述

+ +

每次 arr 发生任何变化时，回调函数将被调用，调用参数为所有变化按发生顺序组成的数组。

+ +
+

通过Array方法如 Array.prototype.pop( ) 触发的变化将被报告成"splice"变化，长度不变但索引赋值发生变化的将被报告成"update"变化。

+
+ +

示例

+ +

Example: Logging different change types

+ +
var arr = ['a', 'b', 'c'];
+
+Array.observe(arr, function(changes) {
+  console.log(changes);
+});
+
+arr[1] = 'B';
+// [{type: 'update', object: <arr>, name: '1', oldValue: 'b'}]
+
+arr[3] = 'd';
+// [{type: 'splice', object: <arr>, index: 3, removed: [], addedCount: 1}]
+
+arr.splice(1, 2, 'beta', 'gamma', 'delta');
+// [{type: 'splice', object: <arr>, index: 1, removed: ['B', 'c'], addedCount: 3}]
+
+ +

标准规范

+ +

Strawman proposal specification.

+ +

浏览器支持

+ +
+
+ + +

{{Compat("javascript.builtins.Array.observe")}}

+
+
+ +

相关内容

+ + -- cgit v1.2.3-54-g00ecf