Admin: Created page with "`__CR.ready` is a function which takes two parameters: # a function with signature `function (context) { ... }` # an optional `context` param..."

2018-11-14T23:02:21Z

Created page with "<code>__CR.ready</code> is a function which takes two parameters: # a function with signature <code>function (context) { ... }</code> # an optional <code>context</code> param..."

New page

<code>__CR.ready</code> is a function which takes two parameters:

# a function with signature <code>function (context) { ... }</code>
# an optional <code>context</code> parameter which is passed as the first parameter

Example usage:

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

The function passed in ''may'' be executed after the '''[https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded DOMContentLoaded]''' event in a browser, often called the '''[[DOM]] Ready''' event. If the '''[[DOM]] Ready''' has already occurred in the current browser window, the passed in function is called immediately (but asynchronously).

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 you wish to access aspects of the [[DOM|Document Object Model]] in the browser, but are not certain when your code is running and you wish to ensure it runs after the [[DOM]] is loaded. It is equivalent to the [https://api.jquery.com/ready/ jQuery Ready] function, but does not require [[jQuery]].

Any function passed into <code>__CR.ready</code> is guaranteed to be executed '''once and only once'''.

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

== See also ==

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

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

CR.ready - Revision history

Admin: Created page with "__CR.ready is a function which takes two parameters: # a function with signature function (context) { ... } # an optional context param..."

Admin: Created page with "`__CR.ready` is a function which takes two parameters: # a function with signature `function (context) { ... }` # an optional `context` param..."