---
description: https://developer.mozilla.org/en-US/docs/Web/API/Notification
---

# Notification (ok)

Các `Notification`giao diện của [Notifications API](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notifications_API\&usg=ALkJrhjsg7UG8gR-jVimaLqNGV-5W9wv5g) được sử dụng để cấu hình và máy tính để bàn màn hình thông báo cho người dùng. Sự xuất hiện và chức năng cụ thể của các thông báo này khác nhau giữa các nền tảng nhưng nhìn chung chúng cung cấp một cách để cung cấp thông tin không đồng bộ cho người dùng.

### Constructor <a href="#constructor" id="constructor"></a>

[`Notification()`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/Notification\&usg=ALkJrhhRn8v26vFfVVZZWdATLjNI0HWDLA)Tạo một thể hiện mới của `Notification`đối tượng.

### Tính chất <a href="#properties" id="properties"></a>

#### Thuộc tính tĩnh <a href="#static_properties" id="static_properties"></a>

Các thuộc tính này chỉ có sẵn trên `Notification`chính đối tượng.[`Notification.permission`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/permission\&usg=ALkJrhgFeRy5SDi4RW9_Wh7agNxBlLtsZQ) Chỉ đọcMột chuỗi đại diện cho sự cho phép hiện tại để hiển thị thông báo. Các giá trị có thể là:

* `denied` - Người dùng từ chối hiển thị thông báo.
* `granted` - Người dùng chấp nhận có thông báo hiển thị.
* `default` - Không rõ sự lựa chọn của người dùng và do đó trình duyệt sẽ hoạt động như thể giá trị bị từ chối.

[`Notification.maxActions`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/maxActions\&usg=ALkJrhitQSGh9u05RhAHmx4AdPmWfhT5pQ) Chỉ đọc

#### Thuộc tính sơ thẩm <a href="#instance_properties" id="instance_properties"></a>

Các thuộc tính này chỉ có sẵn trên các phiên bản của `Notification`đối tượng.[`Notification.actions`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/actions\&usg=ALkJrhgqbvrqAj3Yl8acmmnWVQpP297yfw) Chỉ đọcMảng hành động của thông báo như được chỉ định trong tham số của hàm tạo.`options`[`Notification.badge`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/badge\&usg=ALkJrhjY-vW26L9opG2Px9qm2yR6lKU93g) Chỉ đọcURL của hình ảnh được sử dụng để thể hiện thông báo khi không có đủ không gian để hiển thị thông báo.[`Notification.body`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/body\&usg=ALkJrhhDXYXuyEIi73e9WZYGeX3VP_jRQg) Chỉ đọcChuỗi cơ thể của thông báo như được chỉ định trong tham số của hàm tạo.`options`[`Notification.data`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/data\&usg=ALkJrhgL8X5GpyjVSSW3sUx9v61sIP40ug) Chỉ đọcTrả về một bản sao có cấu trúc của dữ liệu thông báo.[`Notification.dir`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/dir\&usg=ALkJrhiTo8sxlwq5nU0pOxJIEiRuCIo4rg) Chỉ đọcHướng văn bản của thông báo như được chỉ định trong tham số của hàm tạo.`options`[`Notification.lang`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/lang\&usg=ALkJrhj549j8bHRQlvHtMlRvNTTqFqi4gA) Chỉ đọcMã ngôn ngữ của thông báo như được chỉ định trong tham số của hàm tạo.`options`[`Notification.tag`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/tag\&usg=ALkJrhiXJmES9M02hN3uOn8QE-o14ygqrg) Chỉ đọcID của thông báo (nếu có) như được chỉ định trong tham số của hàm tạo.`options`[`Notification.icon`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/icon\&usg=ALkJrhg1N7rb6UK1kT-btDVFpKAaV16xqA) Chỉ đọcURL của hình ảnh được sử dụng làm biểu tượng của thông báo như được chỉ định trong tham số của nhà xây dựng .`options`[`Notification.image`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/image\&usg=ALkJrhjWQfR8Te68yOhehHkoSjgKKXMkcQ) Chỉ đọcURL của hình ảnh sẽ được hiển thị như một phần của thông báo, như được chỉ định trong tham số của nhà xây dựng .`options`[`Notification.renotify`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/renotify\&usg=ALkJrhiGPxIAjKEcehZ0qWemZNenH3QVLw) Chỉ đọcChỉ định xem người dùng có nên được thông báo sau khi thông báo mới thay thế thông báo cũ hay không.[`Notification.requireInteraction`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/requireInteraction\&usg=ALkJrhgMWNi86ND8WvbVY8lou2ZWRDyY5g) Chỉ đọcMột [`Boolean`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean\&usg=ALkJrhiTYBNDinsjmdXP8EhLUgmlAcU8ew)thông báo cho biết rằng một thông báo sẽ vẫn hoạt động cho đến khi người dùng nhấp hoặc loại bỏ nó, thay vì tự động đóng lại.[`Notification.silent`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/silent\&usg=ALkJrhiOnHTcIm2SN4-RBdjkrxGZV0bBuw) Chỉ đọcChỉ định xem thông báo có nên im lặng hay không - nghĩa là không phát ra âm thanh hoặc rung, bất kể cài đặt của thiết bị.[`Notification.timestamp`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/timestamp\&usg=ALkJrhiLzkpTvIhPDrhKBsjCSxbPLl_GZg) Chỉ đọcChỉ định thời gian mà thông báo được tạo hoặc áp dụng (quá khứ, hiện tại hoặc tương lai).[`Notification.title`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/title\&usg=ALkJrhhr2oMCpZKhmpG37J33aFCWGhwvGQ) Chỉ đọcTiêu đề của thông báo như được chỉ định trong tham số đầu tiên của hàm tạo.[`Notification.vibrate`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/vibrate\&usg=ALkJrhjuEMaS_LMgsMRPwpmxwaRvibOQtA) Chỉ đọcChỉ định kiểu rung cho các thiết bị có phần cứng rung phát ra.

**Xử lý sự kiện**

[`Notification.onclick`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/onclick\&usg=ALkJrhiLN_drNoVCagh0nGEQ1qJqFRkkYA)Một xử lý cho [`click`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event\&usg=ALkJrhjHuMqiHrsjMJaL0dL992olS9s4QQ)sự kiện này. Nó được kích hoạt mỗi khi người dùng nhấp vào thông báo.[`Notification.onclose`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/onclose\&usg=ALkJrhjkOjxW7AX7jNVIoh66yIcO3Pcpeg)Một xử lý cho [`close`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/HTMLDialogElement/close_event\&usg=ALkJrhimg0ctqkepPxjQL5-nKSvzotCbrw)sự kiện này. Nó được kích hoạt khi người dùng đóng thông báo.[`Notification.onerror`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/onerror\&usg=ALkJrhhQ2__gFaJQX9HG8bTtAf9PWbwOlg)Một xử lý cho [`error`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/error_event\&usg=ALkJrhiRorHLLbVNLW3KDJpg9Bd52rOuWw)sự kiện này. Nó được kích hoạt mỗi khi thông báo gặp lỗi.[`Notification.onshow`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/onshow\&usg=ALkJrhjNWZRAsirzW34yw_YxZhEEzoetvw)Một xử lý cho [`show`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Element/show_event\&usg=ALkJrhgKa1Y_NdncthuGOguwg3wcVXdkOQ)sự kiện này. Nó được kích hoạt khi thông báo được hiển thị.

### Phương pháp <a href="#methods" id="methods"></a>

#### Phương thức tĩnh <a href="#static_methods" id="static_methods"></a>

Các phương thức này chỉ có sẵn trên `Notification`chính đối tượng.[`Notification.requestPermission()`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/requestPermission\&usg=ALkJrhj06Dn-0iLXOODpcjspvYjirrP9cw)Yêu cầu sự cho phép từ người dùng để hiển thị thông báo.

#### Phương pháp sơ thẩm <a href="#instance_methods" id="instance_methods"></a>

Các thuộc tính này chỉ có sẵn trên một thể hiện của `Notification`đối tượng hoặc thông qua nó [`prototype`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Inheritance_and_the_prototype_chain\&usg=ALkJrhiUUGwrWc2J91fCr5-N2L9hHuedEA). Đối `Notification`tượng cũng kế thừa từ [`EventTarget`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/EventTarget\&usg=ALkJrhgeYVx20Pu9YK2hf-4I74zFLROqVw)giao diện.[`Notification.close()`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/API/Notification/close\&usg=ALkJrhjLIkozle3uTdqxiUcYoe5ccS6i3A)Lập trình đóng một thể hiện thông báo.

### Ví dụ <a href="#examples" id="examples"></a>

Giả sử HTML cơ bản này:

```
<button onclick="notifyMe()">Notify me!</button>
```

Bạn có thể gửi thông báo như sau - ở đây chúng tôi trình bày một bộ mã khá dài và đầy đủ mà bạn có thể sử dụng nếu trước tiên bạn muốn kiểm tra xem thông báo có được hỗ trợ hay không, sau đó kiểm tra xem có được cấp cho nguồn gốc hiện tại để gửi thông báo hay không, sau đó yêu cầu sự cho phép nếu được yêu cầu, trước khi gửi thông báo.

```
function notifyMe() {
  // Let's check if the browser supports notifications
  if (!("Notification" in window)) {
    alert("This browser does not support desktop notification");
  }

  // Let's check whether notification permissions have already been granted
  else if (Notification.permission === "granted") {
    // If it's okay let's create a notification
    var notification = new Notification("Hi there!");
  }

  // Otherwise, we need to ask the user for permission
  else if (Notification.permission !== "denied") {
    Notification.requestPermission().then(function (permission) {
      // If the user accepts, let's create a notification
      if (permission === "granted") {
        var notification = new Notification("Hi there!");
      }
    });
  }

  // At last, if the user has denied notifications, and you 
  // want to be respectful there is no need to bother them any more.
}
```

Chúng tôi không còn hiển thị một mẫu trực tiếp trên trang này nữa, vì Chrome và Firefox không còn cho phép các quyền thông báo được yêu cầu từ các nguồn gốc chéo [`<iframe>`](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe\&usg=ALkJrhhGRf9_40lvj5ONeOiBXkauNvNA5g), với các trình duyệt khác để theo dõi. Để xem ví dụ đang hoạt động, hãy xem [ví dụ về danh sách Công việc](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://github.com/mdn/to-do-notifications/tree/gh-pages\&usg=ALkJrhgkHuZZyo-byOvr_4eaCv3ro5F3gQ) của chúng tôi (cũng xem [ứng dụng đang chạy trực tiếp](https://translate.googleusercontent.com/translate_c?depth=1\&pto=aue\&rurl=translate.google.com.vn\&sl=en\&sp=nmt4\&tl=vi\&u=https://mdn.github.io/to-do-notifications/\&usg=ALkJrhg9PXx5EP0CY4A6hJzeJG4yfjrqZg) .)

**Lưu ý** : Trong ví dụ trên, chúng tôi sinh ra các thông báo để đáp lại cử chỉ của người dùng (nhấp vào nút). Đây không chỉ là cách thực hành tốt nhất - bạn không nên spam người dùng bằng các thông báo mà họ không đồng ý - nhưng các trình duyệt chuyển tiếp sẽ không cho phép thông báo rõ ràng không được kích hoạt để đáp lại cử chỉ của người dùng. Firefox đã làm điều này từ phiên bản 72 chẳng hạn.

### Thông số kỹ thuật <a href="#specifications" id="specifications"></a>
