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

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

เมธอด

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

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

getLocation(function)

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

Index.html

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

พารามิเตอร์

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

ออบเจ็กต์ตำแหน่ง

ตารางต่อไปนี้แสดงตัวอย่างองค์ประกอบสถานที่ที่จะระบุหาก มีการค้นหา 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"]}