launch_handler
Khả dụng hạn chế
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
Member launch_handler xác định các giá trị điều khiển việc khởi chạy một ứng dụng web. Hiện tại nó chỉ có thể chứa một giá trị duy nhất, client_mode, giá trị này chỉ định ngữ cảnh mà ứng dụng nên được tải vào khi khởi chạy. Ví dụ, trong một web app client hiện có đang chứa một thể hiện của ứng dụng, hoặc trong một web app client mới. Điều này để ngỏ chỗ cho nhiều giá trị launch_handler hơn được định nghĩa trong tương lai.
Giá trị
Đối tượng launch_handler có thể chứa các giá trị sau:
client_modeThử nghiệm-
Một chuỗi, hoặc một mảng chuỗi phân tách bằng dấu phẩy, chỉ định ngữ cảnh mà ứng dụng nên được tải vào khi khởi chạy. Nếu cung cấp một mảng chuỗi, giá trị hợp lệ đầu tiên sẽ được dùng. Các giá trị có thể là:
auto-
Tác nhân người dùng quyết định ngữ cảnh nào phù hợp với nền tảng để tải ứng dụng vào. Ví dụ,
navigate-existingcó thể hợp lý hơn trên di động, nơi một thể hiện ứng dụng đơn là phổ biến, trong khinavigate-newcó thể hợp lý hơn trong ngữ cảnh máy tính để bàn. Đây là giá trị mặc định nếu tất cả giá trị được cung cấp đều không hợp lệ. focus-existing-
Nếu ứng dụng đã được tải trong một web app client, nó sẽ được đưa vào focus nhưng không được điều hướng tới URL đích khởi chạy. URL đích được cung cấp thông qua
Window.launchQueueđể có thể triển khai xử lý điều hướng khởi chạy tùy chỉnh. Nếu ứng dụng chưa được tải trong web app client, hành vinavigate-newsẽ được dùng thay thế. -
Nếu ứng dụng đã được tải trong một web app client, nó sẽ được đưa vào focus và được điều hướng tới URL đích khởi chạy đã chỉ định. URL đích được cung cấp thông qua
Window.launchQueueđể có thể triển khai thêm xử lý điều hướng khởi chạy tùy chỉnh. Nếu ứng dụng chưa được tải trong web app client, hành vinavigate-newsẽ được dùng thay thế. -
Ứng dụng được tải bên trong một web app client mới. URL đích được cung cấp thông qua
Window.launchQueueđể có thể triển khai thêm xử lý điều hướng khởi chạy tùy chỉnh.
Ví dụ
{
"launch_handler": {
"client_mode": "focus-existing"
}
}
{
"launch_handler": {
"client_mode": ["focus-existing", "auto"]
}
}
Đặc tả
| Thông số kỹ thuật |
|---|
| Web App Launch Handler API # launch_handler-member |