Klasse google.script.url (Clientseitiges API)

google.script.url ist ein asynchrones clientseitiges JavaScript API, die URLs abfragen kann, um die aktuellen URL-Parameter und das URL-Fragment abzurufen. Diese API unterstützt den google.script.history der API erstellen. Sie kann nur im Kontext einer Webanwendung verwendet werden, IFRAME Es ist nicht für die Verwendung mit Seitenleisten und Dialogfeldern in einem Add-on oder container-script-Kontext. Weitere Informationen finden Sie in der Leitfaden zur Verwendung des Browsers in Web-Apps.

Methoden

MethodeRückgabetypKurzbeschreibung
getLocation(function) void Ruft ein URL-Standortobjekt ab und übergibt es an das angegebene Callback. .

Detaillierte Dokumentation

getLocation(function)

Ruft ein URL-Standortobjekt ab und übergibt es an das angegebene Callback. -Funktion (als einziges Argument).

Index.html

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

Parameter

NameTypBeschreibung
functionFunctionclientseitig Callback-Funktion ausgeführt werden soll. Standortobjekt als einziges Argument.

Standortobjekt

Die folgende Tabelle enthält Beispiele für location -Elemente, die angegeben werden würden, wenn die folgende URL wurde abgefragt: http://www.example.com?n=1&name=alice&n=2#headingAnchor
Felder
location.hash

Stringwert des URL-Fragments nach dem Zeichen # oder ein leerer String, wenn kein URL-Fragment vorhanden ist

headingAnchor
location.parameter

Ein Objekt mit Schlüssel/Wert-Paaren, die der URL-Anfrage entsprechen Parameter. Für Parameter wird nur der erste Wert zurückgegeben die mehrere Werte haben. Wenn keine Parameter vorhanden sind, ein leeres Objekt sein.

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

Ein Objekt, das location.parameter ähnelt, aber mit ein Array von Werten für jeden Schlüssel. Wenn keine Parameter vorhanden sind, ein leeres Objekt sein.

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