Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

Apps.getSelf

Non standard
Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

Résumé

Renvoie les informations sur l'application courante, ce qui veut dire une application installée dont le domaine correspond au domaine de l'application appelée.

Note : Plusieurs applications pour une même origine ne sont pas supportées. Pour héberger plusieurs applications depuis un domaine, créer un sous-domaine pour chaque application. Par exemple : monapp.mondomaine.com, autreapp.mondomaine.com, et ainsi de suite.

Syntaxe

var requete = window.navigator.mozApps.getSelf();

Paramètres

Aucun.

Renvoie

getSelf() renvoie un objet DOMRequest. Le champ DOMRequest.result contient un objet App, qui est un objet JavaScript décrivant l'application. Avant que l'opération soit terminée, DOMRequest.result est null.

Note : A cause du bug 806597, requete.result retourne incorrectement null même sur l'application tourne sur l'ordinateur ou Firefox pour Android.

Si l'appel est un echec, DOMRequest.error contient un objet DOMError, qui contient des informations sur l'erreur.

Exemple

Un exemple montrant comme utiliser getSelf() avec les propriétés de callback DOMRequest.onsuccess et DOMRequest.onerror.

var requete = window.navigator.mozApps.getSelf();
requete.onsuccess = function() {
  // Affiche le nom de l'application depuis l'objet App
  alert("Nom de l'application : " + requete.result.manifest.name);
};
requete.onerror = function() {
  // Affiche le nom de l'erreur depuis l'objet DOMError
  alert("Erreur : " + requete.error.name);
};

Si l'appel est réussi, un objet App est renvoyé dans la propriété result de l'objet renvoyé. Dans cette exemple, il s'agit de requete.result.

Sujets en relation

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : fscholz, teoli, khalid32, tregagnon
 Dernière mise à jour par : khalid32,