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

google.script.url là một JavaScript phía máy khách không đồng bộ API có thể truy vấn các URL để lấy phân đoạn và tham số URL hiện tại. API này hỗ trợ google.script.history API. Chỉ có thể dùng trong ngữ cảnh của một ứng dụng web sử dụng IFRAME. Tính năng này không nhằm sử dụng với thanh bên và hộp thoại trong tiện ích bổ sung hoặc ngữ cảnh tập lệnh vùng chứa. Để biết thêm thông tin, hãy xem hướng dẫn sử dụng trình duyệt nhật ký hoạt động trong ứng dụng web.

Phương thức

Phương thứcLoại 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 lệnh gọi lại được chỉ định .

Tài liệu chi tiết

getLocation(function)

Lấy đối tượng vị trí URL rồi truyền đối tượng đó đến lệnh gọi lại đượ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);
});

Tham số

TênLoạiMô tả
functionFunctionphía máy khách để chạy, sử dụng hàm callback đối tượng vị trí làm đối số duy nhất.

Đối tượng vị trí

Bảng sau đây hiển thị 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
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

headingAnchor
location.parameter

Đối tượng của các cặp khoá/giá trị tương ứng với yêu cầu URL tham số. Hệ thống sẽ chỉ trả về giá trị đầu tiên cho thông số có nhiều giá trị. Nếu không có tham số nào, hàm này sẽ là đố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, hàm này sẽ là đối tượng trống.

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