คลาส google.script.url (API ฝั่งไคลเอ็นต์)

google.script.url คือ JavaScript API ฝั่งไคลเอ็นต์แบบอะซิงโครนัสที่ค้นหา URL เพื่อรับพารามิเตอร์และส่วนย่อยของ URL ปัจจุบันได้ API นี้รองรับ google.script.history API และใช้ในบริบทของเว็บแอปที่ใช้ IFRAME เท่านั้น ไม่ได้ใช้สําหรับแถบด้านข้างและกล่องโต้ตอบในบริบทส่วนเสริมหรือสคริปต์คอนเทนเนอร์ หากต้องการข้อมูลเพิ่มเติม โปรดอ่านคู่มือการใช้ประวัติการท่องเว็บในเว็บแอป

เมธอด

วิธีการประเภทการแสดงผลรายละเอียดแบบย่อ
getLocation(function) void รับออบเจ็กต์ตําแหน่ง URL และส่งไปยังฟังก์ชันเรียกกลับที่ระบุ

เอกสารประกอบโดยละเอียด

getLocation(function)

รับออบเจ็กต์ตําแหน่ง URL และส่งไปยังฟังก์ชันเรียกกลับที่ระบุ (เป็นอาร์กิวเมนต์เดียว)

Index.html

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

พารามิเตอร์

ชื่อประเภทคำอธิบาย
functionFunctionฟังก์ชันเรียกกลับฝั่งไคลเอ็นต์ที่จะเรียกใช้ โดยใช้ออบเจ็กต์ตําแหน่งเป็นอาร์กิวเมนต์เดียว

ออบเจ็กต์สถานที่ตั้ง

ตารางต่อไปนี้แสดงตัวอย่างองค์ประกอบตําแหน่งที่จะระบุไว้หากมีการค้นหา URL ต่อไปนี้ http://www.example.com?n=1&name=alice&n=2#headingAnchor
ช่อง
location.hash

ค่าสตริงของส่วนย่อย URL หลังอักขระ # หรือสตริงว่างหากไม่มีส่วนย่อยของ URL

headingAnchor
location.parameter

ออบเจ็กต์ของคู่คีย์-ค่าที่สอดคล้องกับพารามิเตอร์ของคําขอ URL ระบบจะแสดงผลเฉพาะค่าแรกสําหรับพารามิเตอร์ที่มีหลายค่า หากไม่มีพารามิเตอร์ ออบเจ็กต์นี้จะว่างเปล่า

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

ออบเจ็กต์ที่คล้ายกับ location.parameter แต่มีการระบุอาร์เรย์ของค่าสําหรับแต่ละคีย์ หากไม่มีพารามิเตอร์ ออบเจ็กต์นี้จะว่างเปล่า

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