google.script.url
là một API JavaScript phía máy khách không đồng bộ có thể truy vấn các URL để lấy các tham số URL và mảnh hiện tại.
API này hỗ trợ API google.script.history
. Bạn chỉ có thể dùng thuộc tính này trong ngữ cảnh của một ứng dụng web sử dụng IFRAME
.
Không dùng được với thanh bên và hộp thoại trong ngữ cảnh tiện ích bổ sung hoặc tập lệnh vùng chứa. Để biết thêm thông tin, hãy xem bài viết hướng dẫn sử dụng nhật ký duyệt web trong ứng dụng web.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
getLocation(function) |
void |
Lấy đối tượng vị trí URL và truyền đối tượng đó đến hàm callback đã chỉ định. |
Tài liệu chi tiết
getLocation(function)
Lấy một đối tượng vị trí URL và truyền đối tượng đó vào hàm callback được chỉ định (làm đối số duy nhất).
Index.html
google.script.url.getLocation(function(location) { console.log(location.parameters); console.log(location.hash); });
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
function | Function | một hàm callback phía máy khách để chạy, sử dụng đối tượng vị trí làm đối số duy nhất. |
Đối tượng vị trí
Bảng sau đây cho thấy ví dụ về các phần tử vị trí sẽ được chỉ định nếu URL sau được truy vấn:http://www.example.com?n=1&name=alice&n=2#headingAnchor
Các trường | |
---|---|
location.hash |
Giá trị chuỗi của phân đoạn URL sau ký tự headingAnchor |
location.parameter |
Một đối tượng của các cặp khoá/giá trị tương ứng với các tham số của yêu cầu URL. Hệ thống chỉ trả về giá trị đầu tiên đối với các thông số có nhiều giá trị. Nếu không có tham số nào, thì đây sẽ là một đối tượng trống. {"name": "alice", "n": "1"} |
location.parameters |
Một đối tượng tương tự như {"name": ["alice"], "n": ["1", "2"]} |