Klasse google.script.url (Clientseitiges API)
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
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
Methode | Rückgabetyp | Kurzbeschreibung |
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
Name | Typ | Beschreibung |
function | Function | clientseitig
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"]}
|
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003e\u003ccode\u003egoogle.script.url\u003c/code\u003e is a client-side JavaScript API for querying URLs to get parameters and fragments within web apps.\u003c/p\u003e\n"],["\u003cp\u003eThis API works with \u003ccode\u003egoogle.script.history\u003c/code\u003e and requires the use of \u003ccode\u003eIFRAME\u003c/code\u003e in your web app.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetLocation()\u003c/code\u003e method retrieves a URL location object containing parameters and hash information, passing it to a callback function.\u003c/p\u003e\n"],["\u003cp\u003eThe location object provides access to URL components like hash, individual parameters, and all parameter values.\u003c/p\u003e\n"]]],[],null,["# Class google.script.url (Client-side API)\n\n`google.script.url` is an asynchronous client-side JavaScript\nAPI that can query URLs to obtain the current URL parameters and fragment.\nThis API supports the [`google.script.history`](/apps-script/guides/html/reference/history)\nAPI. It can only be used in the context of a web app that uses\n[`IFRAME`](/apps-script/reference/html/sandbox-mode#properties).\nIt is not intended for use with sidebars and dialogs in an add-on or\ncontainer-script context. For more information, see the\n[guide to using browser\nhistory in web apps](/apps-script/guides/web#web_apps_and_browser_history). \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------|-------------|------------------------------------------------------------------------------|\n| [getLocation(function)](#getLocation(Function)) | `void` | Gets a URL location object and passes it to the specified callback function. |\n\nDetailed documentation\n----------------------\n\n### `getLocation(function)`\n\nGets a [URL location object](#locationObject) and passes it to the specified callback\nfunction (as the only argument). \n\n### Index.html\n\n```html\ngoogle.script.url.getLocation(function(location) {\n console.log(location.parameters);\n console.log(location.hash);\n});\n```\n\n#### Parameters\n\n| Name | Type | Description |\n|------------|------------|------------------------------------------------------------------------------------------------------------|\n| `function` | `Function` | a client-side callback function to run, using the [location object](#locationObject) as the only argument. |\n\n#### Location object\n\nThe following table shows examples of the location elements that would be specified if the following URL was queried: `http://www.example.com?n=1&name=alice&n=2#headingAnchor`\n\n| Fields ||\n|-----------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `location.hash` | The string value of URL fragment after the `#` character, or an empty string if no URL fragment is present ``` headingAnchor ``` |\n| `location.parameter` | An object of key/value pairs that correspond to the URL request parameters. Only the first value will be returned for parameters that have multiple values. If no parameters are present, this will be an empty object. ``` {\"name\": \"alice\", \"n\": \"1\"} ``` |\n| `location.parameters` | An object similar to `location.parameter`, but with an array of values for each key. If no parameters are present, this will be an empty object. ``` {\"name\": [\"alice\"], \"n\": [\"1\", \"2\"]} ``` |\n\n*** ** * ** ***"]]