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.