Yoctopuce Yocto-GPS, User Manual

Page: 217 / 572

20. High-level API Reference
YModule module
→
load_async()
Preloads the module cache with a specified validity duration (asynchronous version).
js
function load_async( msValidity , callback , context )
nodejs
function load_async( msValidity , callback , context )
By default, whenever accessing a device, all module attributes are kept in cache for the standard
duration (5 ms). This method can be used to temporarily mark the cache as valid for a longer period, in
order to reduce network traffic for instance.
This asynchronous version exists only in Javascript. It uses a callback instead of a return value in order
to avoid blocking Firefox javascript VM that does not implement context switching during blocking I/O
calls. See the documentation section on asynchronous Javascript calls for more details.
Parameters :
msValidity an integer corresponding to the validity of the loaded module parameters, in milliseconds
callback callback function that is invoked when the result is known. The callback function receives three
arguments: the caller-specific context object, the receiving module object and the error code
(or
YAPI_SUCCESS )
context caller-specific object that is passed as-is to the callback function
Returns :
nothing : the result is provided to the callback.
www.yoctopuce.com 211