Classe google.script.url (API côté client)

google.script.url est un code JavaScript asynchrone côté client. API capable d'interroger des URL pour obtenir les paramètres d'URL actuels et le fragment. Cette API est compatible avec la google.script.history API. Il ne peut être utilisé que dans le contexte d'une application Web qui utilise IFRAME Elle n'est pas destinée à être utilisée avec les barres latérales et les boîtes de dialogue d'un module complémentaire ou conteneur-script. Pour en savoir plus, consultez les guide d'utilisation du navigateur dans les applications Web.

Méthodes

MéthodeType renvoyéBrève description
getLocation(function) void Récupère un objet location d'URL et le transmet au rappel spécifié. .

Documentation détaillée

getLocation(function)

Elle récupère un objet de localisation d'URL et le transmet au rappel spécifié. (comme seul argument).

Index.html

google.script.url.getLocation(function(location) {
  console.log(location.parameters);
  console.log(location.hash);
});

Paramètres

NomTypeDescription
functionFunctioncôté client de rappel à exécuter, à l'aide de la location_object comme seul argument.

Objet Location

Le tableau suivant présente des exemples d'éléments "location" qui seraient spécifiés si le L'URL suivante a été interrogée: http://www.example.com?n=1&name=alice&n=2#headingAnchor
Champs
location.hash

Valeur de chaîne du fragment d'URL après le caractère #, ou une chaîne vide en l'absence de fragment d'URL

headingAnchor
location.parameter

Un objet de paires clé/valeur correspondant à la requête URL paramètres. Seule la première valeur est renvoyée pour les paramètres. comportant plusieurs valeurs. Si aucun paramètre n'est présent, être un objet vide.

{"name": "alice", "n": "1"}
location.parameters

Un objet semblable à location.parameter, mais avec un tableau de valeurs pour chaque clé. Si aucun paramètre n'est présent, être un objet vide.

{"name": ["alice"], "n": ["1", "2"]}