Object.prototype.unwatch()

Deprecation warning: Do not use unwatch() and watch()! These two methods were implemented only in Firefox prior to version 58, they're deprecated and removed in Firefox 58+. In addition, using watchpoints has a serious negative impact on performance, which is especially true when used on global objects, such as window. You can usually use setters and getters or proxies instead.

The unwatch() method removes a watchpoint set with the watch() method.

Syntax

obj.unwatch(prop)

Parameters

prop
The name of a property of the object to stop watching.

Return value

undefined.

Description

The JavaScript debugger has functionality similar to that provided by this method, as well as other debugging options. For information on the debugger, see Venkman.

By default, this method is inherited by every object descended from Object.

Note: The reason for unwatch() to take the property name prop as its only parameter is due to the "single handler allowing" behavior of the watch() method.

Examples

See watch().

Specifications

Not part of any standard.

Browser compatibility

Not supported anywhere. Historically supported in Firefox 1 till 57.

Compatibility notes

  • Calling unwatch() on the Document object throws a TypeError since Firefox 23 (bug 903332). This regression has been fixed with Firefox 27.

See also