MediaError: thuộc tính message
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Thuộc tính chỉ đọc MediaError.message trả về chuỗi mà con người có thể đọc cung cấp chi tiết chẩn đoán cụ thể liên quan đến lỗi được mô tả bởi đối tượng MediaError, hoặc chuỗi rỗng ("") nếu không thể xác định hoặc cung cấp thông tin chẩn đoán.
Giá trị
Chuỗi cung cấp giải thích chi tiết, cụ thể về những gì đã xảy ra sai và có thể cách sửa. Đây không phải là mô tả chung về giá trị thuộc tính MediaError.code, mà đi sâu hơn vào các chi tiết cụ thể của lỗi cụ thể này và hoàn cảnh của nó. Nếu không có chi tiết cụ thể nào có sẵn, chuỗi này trống.
Ví dụ
>Ghi nhật ký thông báo MediaError
Ví dụ này tạo phần tử <audio>, thiết lập trình xử lý lỗi cho nó, sau đó cho phép người dùng nhấp vào các nút để chỉ định có gán tệp âm thanh hợp lệ hay tệp bị thiếu cho thuộc tính src của phần tử. Trình xử lý lỗi xuất các dòng nhật ký vào hộp trên màn hình mô tả lỗi, bao gồm code, message, và gợi ý có thể hữu ích hơn cho khách truy cập so với message chẩn đoán:
Ví dụ tạo phần tử <audio> và cho phép người dùng gán tệp nhạc hợp lệ hoặc liên kết đến tệp không tồn tại. Điều này cho phép chúng ta xem hành vi của trình xử lý sự kiện error, nhận được bởi trình xử lý sự kiện chúng ta thêm vào phần tử <audio> chính.
Đầu tiên, nó lấy đối tượng MediaError mô tả lỗi từ thuộc tính error trên HTMLAudioElement đại diện cho trình phát âm thanh. code số của lỗi được kiểm tra so với các hằng số MediaError, ban đầu không xác định. Nếu err.code bằng bất kỳ hằng số nào, nó tạo gợi ý chung với MediaError.message được thêm vào dòng nhật ký để cung cấp thông tin chẩn đoán chi tiết hơn cho các nhà phát triển. Văn bản kết quả được thêm vào phần tử <pre>:
Nhấp vào nút "Valid file" để bắt đầu phát như mong đợi, nút "Missing file" để thử tải tài nguyên bị thiếu, và nút "Wrong format" để thử đặt tệp SVG làm nguồn cho phần tử âm thanh. So sánh đầu ra nhật ký cho hai trường hợp lỗi minh họa sự khác biệt giữa code và message của MediaError:
Thông số kỹ thuật
| Specification |
|---|
| HTML> # dom-mediaerror-message-dev> |
Tương thích trình duyệt
Xem thêm
MediaError: Giao diện được sử dụng để định nghĩa thuộc tínhMediaError.message<audio>,<video>