CR.watchers - Revision history

Admin at 16:50, 27 April 2026

2026-04-27T16:50:46Z

Admin at 16:46, 27 April 2026

2026-04-27T16:46:46Z

Admin at 16:18, 27 April 2026

2026-04-27T16:18:01Z

Admin at 17:26, 30 January 2021

2021-01-30T17:26:36Z

Admin at 23:13, 14 November 2018

2018-11-14T23:13:21Z

Admin: Created page with "`__CR.watchers` is a member in the ConversionRuler Global Object, and is of type `array`. It represents a queue of functions to run, intermittently,..."

2018-11-14T23:12:49Z

Created page with "<code>__CR.watchers</code> is a member in the ConversionRuler Global Object, and is of type <code>array</code>. It represents a queue of functions to run, intermittently,..."

New page

<code>__CR.watchers</code> is a member in the [[ConversionRuler Global Object]], and is of type <code>array</code>. It represents a queue of functions to run, intermittently, to check for a condition which may exist on the page. The functions in this queue are run several times a second to monitor the [[DOM]] and the page for changes to the page which may represent [[Conversion Actions]].

The passed in watcher function will be called several times a second until the function returns the exact value of <code>false</code> – any other value returned will leave the watcher function in the queue indefinitely, or until the function returns <code>false</code>.

Example usage:

<script>
__CR.watchers.push(function (cr) {
if (document.getElementById('message-sent')) {
cr.track("newsletter", null, cr.data("email"));
return false;
}
});
</script>

The signature of the function added to this queue is <code>function (cr) { }</code>, and

The first parameter is the [[ConversionRuler Global Object]] (e.g. <code>__CR</code>) and the value for <code>this</code> in the passed-in function is typically set to the browser global object <code>window</code>.

This function should be used when a browser web application or web form modifies the [[DOM]] and you need to monitor the [[DOM]] for changes.

This function is only available as of ''September 12, 2018''.

== See also ==

* [[:Category:ConversionRuler JavaScript Functions|JavaScript Functions]]
* [[__CR.ready]]
* [[Tracking Queue]]

[[Category:ConversionRuler]]
[[Category:ConversionRuler JavaScript Functions]]

← Older revision		Revision as of 16:50, 27 April 2026
Line 36:		Line 36:
	[[Category:ConversionRuler]]		[[Category:ConversionRuler]]
	[[Category:ConversionRuler Deprecated]]		[[Category:ConversionRuler Deprecated]]
−	~~[[Category:ConversionRuler JavaScript Functions]]~~

← Older revision		Revision as of 16:46, 27 April 2026
Line 35:		Line 35:

	[[Category:ConversionRuler]]		[[Category:ConversionRuler]]
		+	[[Category:ConversionRuler Deprecated]]
	[[Category:ConversionRuler JavaScript Functions]]		[[Category:ConversionRuler JavaScript Functions]]

← Older revision		Revision as of 16:18, 27 April 2026
Line 1:		Line 1:
		+	{{deprecated\|when=2025}}
		+
		+	See [[__CR.watch]] which is the function which replaces this member.
		+
		+	This member remains compatible, however, the value of `__CR.watchers` when read is not guaranteed to match versions prior to 2025.
		+
	<code>__CR.watchers</code> is a member in the [[ConversionRuler JavaScript Global]], and is of type <code>array</code>. It represents a queue of functions to run, intermittently, to check for a condition which may exist on the page. The functions in this queue are run several times a second to monitor the [[DOM]] and the page for changes to the page which may represent [[Conversion Actions]].		<code>__CR.watchers</code> is a member in the [[ConversionRuler JavaScript Global]], and is of type <code>array</code>. It represents a queue of functions to run, intermittently, to check for a condition which may exist on the page. The functions in this queue are run several times a second to monitor the [[DOM]] and the page for changes to the page which may represent [[Conversion Actions]].

@@ Line 20: / Line 20: @@
 This function should be used when a browser web application or web form modifies the [[DOM]] and you need to monitor the [[DOM]] for changes.
-This function is only available as of ''September 12, 2018''.
+This functionality is only available as of ''September 12, 2018''.
 == See also ==

@@ Line 1: / Line 1: @@
-<code>__CR.watchers</code> is a member in the [[ConversionRuler Global Object]], and is of type <code>array</code>. It represents a queue of functions to run, intermittently, to check for a condition which may exist on the page. The functions in this queue are run several times a second to monitor the [[DOM]] and the page for changes to the page which may represent [[Conversion Actions]].
+<code>__CR.watchers</code> is a member in the [[ConversionRuler JavaScript Global]], and is of type <code>array</code>. It represents a queue of functions to run, intermittently, to check for a condition which may exist on the page. The functions in this queue are run several times a second to monitor the [[DOM]] and the page for changes to the page which may represent [[Conversion Actions]].
 The passed in watcher function will be called several times a second until the function returns the exact value of <code>false</code> – any other value returned will leave the watcher function in the queue indefinitely, or until the function returns <code>false</code>.
@@ Line 16: / Line 16: @@
 The signature of the function added to this queue is <code>function (cr) { }</code>, and
-The first parameter is the [[ConversionRuler Global Object]] (e.g. <code>__CR</code>) and the value for <code>this</code> in the passed-in function is typically set to the browser global object <code>window</code>.
+The first parameter is the [[ConversionRuler JavaScript Global]] (e.g. <code>__CR</code>) and the value for <code>this</code> in the passed-in function is typically set to the browser global object <code>window</code>.
 This function should be used when a browser web application or web form modifies the [[DOM]] and you need to monitor the [[DOM]] for changes.