services/sync - mozsearch

firefox-main/services/sync

	Name	Description	Size	Coverage
	components.conf		443	-
	content			75 %
	docs			-
	modules			91 %
	modules-testing			-
	moz.build		2124	-
	pings.yaml		1233	-
	SyncComponents.manifest		151	-
<1%	tests			-
	tps			-
	Weave.sys.mjs	Sync's XPCOM service. It is named "Weave" for historical reasons. It's worth noting how Sync is lazily loaded. We register a timer that loads Sync a few seconds after app startup. This is so Sync does not adversely affect application start time. If Sync is not configured, no extra Sync code is loaded. If an external component (say the UI) needs to interact with Sync, it should use the promise-base function whenLoaded() - something like the following: // 1. Grab a handle to the Sync XPCOM service. let service = Cc["@mozilla.org/weave/service;1"] .getService(Components.interfaces.nsISupports) .wrappedJSObject; // 2. Use the .then method of the promise. service.whenLoaded().then(() => { // You are free to interact with "Weave." objects. return; }); And that's it! However, if you really want to avoid promises and do it old-school, then // 1. Get a reference to the service as done in (1) above. // 2. Check if the service has been initialized. if (service.ready) { // You are free to interact with "Weave." objects. return; } // 3. Install "ready" listener. Services.obs.addObserver(function onReady() { Services.obs.removeObserver(onReady, "weave:service:ready"); // You are free to interact with "Weave." objects. }, "weave:service:ready", false); // 4. Trigger loading of Sync. service.ensureLoaded();	4427	85 %

Revision control

Other Tools