CR.watch - Revision history

Admin at 16:31, 27 April 2026

2026-04-27T16:31:01Z

Admin at 16:25, 27 April 2026

2026-04-27T16:25:14Z

Admin: Created page with "`__CR.watch` is a function in the ConversionRuler JavaScript Global with the following arguments: # `watchFunction` of type ```function``` `wa..."`


2026-04-27T16:23:46Z
Created page with "<code>__CR.watch</code> is a function in the ConversionRuler JavaScript Global with the following arguments:  # <code>watchFunction</code> of type ```function```  <code>wa..."
New page
<code>__CR.watch</code> is a function in the [[ConversionRuler JavaScript Global]] with the following arguments:



# <code>watchFunction</code> of type ```function```



<code>watchFunction</code> is a function which takes the [[ConversionRuler JavaScript Global]] as its first argument. The return value of this function, when `false` and only when `false` - terminates the watcher function permanently.



A watcher function is run, intermittently, to check for a condition which may exist on the page. This function is run ```several times a second``` to monitor the [[DOM]] and the page for changes to the page which may represent [[Conversion Actions]]. When implementing a watcher function, make the amount of time spent by your function as small as possible.



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.watch(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 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.



This functionality is only available as of ''December 31, 2025''.



== See also ==



* [[:Category:ConversionRuler JavaScript Functions|JavaScript Functions]]

* [[__CR.ready]]

* [[Tracking Queue]]



[[Category:ConversionRuler]]

[[Category:ConversionRuler JavaScript Functions]]

CR.watch - Revision history

Admin at 16:31, 27 April 2026

Admin at 16:25, 27 April 2026

Admin: Created page with "__CR.watch is a function in the ConversionRuler JavaScript Global with the following arguments: # watchFunction of type ```function``` wa..."

Admin: Created page with "`__CR.watch` is a function in the ConversionRuler JavaScript Global with the following arguments: # `watchFunction` of type ```function``` `wa..."`