Lớp google.script.url (API phía máy khách)

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ứcKiể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ênLoạiNội dung mô tả
functionFunctionmộ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ự # hoặc một chuỗi trống nếu không có phân đoạn URL nào

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ư location.parameter, nhưng có một mảng giá trị cho mỗi khoá. Nếu không có tham số nào, thì đây sẽ là một đối tượng trống.

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