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); });
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
function | Function | ฟังก์ชันเรียกกลับฝั่งไคลเอ็นต์ที่จะเรียกใช้ โดยใช้ออบเจ็กต์ตําแหน่งเป็นอาร์กิวเมนต์เดียว |
ออบเจ็กต์สถานที่ตั้ง
ตารางต่อไปนี้แสดงตัวอย่างองค์ประกอบตําแหน่งที่จะระบุไว้หากมีการค้นหา URL ต่อไปนี้http://www.example.com?n=1&name=alice&n=2#headingAnchor
ช่อง | |
---|---|
location.hash |
ค่าสตริงของส่วนย่อย URL หลังอักขระ headingAnchor |
location.parameter |
ออบเจ็กต์ของคู่คีย์-ค่าที่สอดคล้องกับพารามิเตอร์ของคําขอ URL ระบบจะแสดงผลเฉพาะค่าแรกสําหรับพารามิเตอร์ที่มีหลายค่า หากไม่มีพารามิเตอร์ ออบเจ็กต์นี้จะว่างเปล่า {"name": "alice", "n": "1"} |
location.parameters |
ออบเจ็กต์ที่คล้ายกับ {"name": ["alice"], "n": ["1", "2"]} |