Window

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

* Some parts of this feature may have varying levels of support.

Giao diện Window đại diện cho một cửa sổ chứa một tài liệu DOM; thuộc tính document trỏ đến tài liệu DOM được tải trong cửa sổ đó.

Bạn có thể lấy một cửa sổ cho tài liệu hiện tại bằng thuộc tính document.defaultView.

Một biến toàn cục, window, đại diện cho cửa sổ mà mã đang chạy, được bộc lộ cho mã JavaScript.

Giao diện Window là nơi chứa nhiều hàm, không gian tên, đối tượng và hàm tạo, không nhất thiết gắn trực tiếp với khái niệm cửa sổ giao diện người dùng. Tuy vậy, Window là một nơi phù hợp để đặt những phần tử cần có sẵn ở phạm vi toàn cục. Nhiều phần trong số đó được mô tả trong Tài liệu tham chiếu JavaScriptTài liệu tham chiếu DOM.

Trong trình duyệt theo thẻ, mỗi thẻ được biểu diễn bởi một đối tượng Window riêng; window toàn cục mà mã JavaScript trong một thẻ nhìn thấy luôn đại diện cho chính thẻ đó. Dù vậy, ngay cả trong trình duyệt theo thẻ, một số thuộc tính và phương thức vẫn áp dụng cho toàn bộ cửa sổ chứa thẻ, chẳng hạn như resizeTo()innerHeight. Nói chung, bất cứ thứ gì không thể hợp lý gắn với một thẻ thì sẽ gắn với cửa sổ.

EventTarget Window

Thuộc tính instance

Giao diện này kế thừa các thuộc tính từ EventTarget.

Lưu ý rằng các thuộc tính là đối tượng (ví dụ để ghi đè prototype của các phần tử dựng sẵn) được liệt kê ở một phần riêng bên dưới.

Window.caches Read only Secure context

Trả về đối tượng CacheStorage gắn với ngữ cảnh hiện tại. Đối tượng này cho phép lưu tài nguyên để dùng khi ngoại tuyến và tạo phản hồi tùy biến cho các yêu cầu.

Window.clientInformation Read only

Một bí danh của Window.navigator.

Window.closed Read only

Cho biết cửa sổ hiện tại đã được đóng hay chưa.

Window.cookieStore Read only Secure context

Trả về tham chiếu đến đối tượng CookieStore cho ngữ cảnh tài liệu hiện tại.

Window.credentialless Read only Experimental

Trả về giá trị boolean cho biết tài liệu hiện tại có được tải bên trong một <iframe> credentialless hay không. Xem thêm IFrame credentialless.

Window.crossOriginIsolated Read only

Trả về giá trị boolean cho biết trang web có đang ở trạng thái cô lập theo nguồn gốc hay không.

Window.crypto Read only

Trả về đối tượng Crypto gắn với đối tượng toàn cục.

Window.customElements Read only

Trả về tham chiếu đến đối tượng CustomElementRegistry, có thể dùng để đăng ký phần tử tùy biến mới và lấy thông tin về các phần tử đã đăng ký trước đó.

Window.devicePixelRatio Read only

Trả về tỉ lệ giữa pixel vật lý và pixel độc lập theo thiết bị trên màn hình hiện tại.

Window.document Read only

Trả về tham chiếu đến tài liệu mà cửa sổ đang chứa.

Window.documentPictureInPicture Read only Experimental Secure context

Trả về tham chiếu đến cửa sổ document Picture-in-Picture của ngữ cảnh tài liệu hiện tại.

Window.fence Read only Experimental

Trả về một thể hiện đối tượng Fence cho ngữ cảnh tài liệu hiện tại. Chỉ có sẵn cho các tài liệu được nhúng bên trong <fencedframe>.

Window.frameElement Read only

Trả về phần tử trong đó cửa sổ được nhúng, hoặc null nếu cửa sổ không được nhúng.

Window.frames Read only

Trả về một mảng các khung con trong cửa sổ hiện tại.

Window.fullScreen Non-standard

Cho biết cửa sổ có đang được hiển thị ở chế độ toàn màn hình hay không.

Window.history Read only

Trả về tham chiếu đến đối tượng history.

Window.indexedDB Read only

Cung cấp cơ chế để ứng dụng truy cập bất đồng bộ các khả năng của cơ sở dữ liệu được lập chỉ mục; trả về đối tượng IDBFactory.

Window.innerHeight Read only

Lấy chiều cao của vùng nội dung của cửa sổ trình duyệt, bao gồm cả thanh cuộn ngang nếu được hiển thị.

Window.innerWidth Read only

Lấy chiều rộng của vùng nội dung của cửa sổ trình duyệt, bao gồm cả thanh cuộn dọc nếu được hiển thị.

Window.isSecureContext Read only

Trả về giá trị boolean cho biết ngữ cảnh hiện tại có an toàn (true) hay không (false).

Window.launchQueue Read only Experimental

Khi một ứng dụng web tiến bộ (PWA) được khởi chạy với giá trị client_mode của launch_handlerfocus-existing, navigate-new, hoặc navigate-existing, launchQueue cung cấp truy cập đến lớp LaunchQueue, cho phép triển khai xử lý điều hướng khởi chạy tùy biến cho PWA.

Window.length Read only

Trả về số lượng khung trong cửa sổ. Xem thêm window.frames.

Window.localStorage Read only

Trả về tham chiếu đến đối tượng lưu trữ cục bộ dùng để lưu dữ liệu chỉ có thể được truy cập bởi nguồn gốc đã tạo ra nó.

Window.location

Lấy/đặt vị trí, hoặc URL hiện tại, của đối tượng cửa sổ.

Window.locationbar Read only

Trả về đối tượng locationbar.

Window.menubar Read only

Trả về đối tượng menubar.

Window.mozInnerScreenX Read only Non-standard

Trả về tọa độ ngang (X) của góc trên bên trái của vùng nhìn thấy của cửa sổ, theo hệ tọa độ màn hình. Giá trị này được báo cáo bằng pixel CSS.

Window.mozInnerScreenY Read only Non-standard

Trả về tọa độ dọc (Y) của góc trên bên trái của vùng nhìn thấy của cửa sổ, theo hệ tọa độ màn hình. Giá trị này được báo cáo bằng pixel CSS.

Window.name

Lấy/đặt tên của cửa sổ.

Window.navigation Read only

Trả về đối tượng Navigation gắn với window hiện tại. Đây là điểm vào của Navigation API.

Window.navigator Read only

Trả về tham chiếu đến đối tượng navigator.

Window.opener

Trả về tham chiếu đến cửa sổ đã mở cửa sổ hiện tại này.

Window.origin Read only

Trả về origin của đối tượng toàn cục, được tuần tự hóa thành chuỗi.

Window.originAgentCluster Read only

Trả về true nếu cửa sổ này thuộc về một cụm tác tử được khóa theo origin.

Window.outerHeight Read only

Trả về chiều cao của phần hiển thị bên ngoài của cửa sổ.

Window.outerWidth Read only

Trả về chiều rộng của phần hiển thị bên ngoài của cửa sổ.

Window.parent Read only

Trả về tham chiếu đến cửa sổ cha.

Window.performance Read only

Trả về đối tượng Performance cho phép đo thời gian và hiệu năng.

Window.personalbar Read only

Trả về đối tượng personalbar.

Window.screen Read only

Trả về đối tượng screen.

Window.screenXWindow.screenLeft Read only

Cả hai thuộc tính đều trả về khoảng cách theo chiều ngang từ mép trái của vùng nhìn thấy của trình duyệt đến cạnh trái của màn hình.

Window.screenYWindow.screenTop Read only

Cả hai thuộc tính đều trả về khoảng cách theo chiều dọc từ mép trên của vùng nhìn thấy của trình duyệt đến cạnh trên của màn hình.

Window.scrollbars Read only

Trả về đối tượng scrollbars.

Window.scrollMaxX Non-standard Read only

Độ lệch tối đa mà cửa sổ có thể cuộn theo chiều ngang, tức là chiều rộng tài liệu trừ chiều rộng khung nhìn.

Window.scrollMaxY Non-standard Read only

Độ lệch tối đa mà cửa sổ có thể cuộn theo chiều dọc, tức là chiều cao tài liệu trừ chiều cao khung nhìn.

Window.scrollX Read only

Trả về số pixel mà tài liệu đã được cuộn theo chiều ngang.

Window.scrollY Read only

Trả về số pixel mà tài liệu đã được cuộn theo chiều dọc.

Window.self Read only

Trả về tham chiếu đến chính đối tượng window.

Window.sessionStorage

Trả về tham chiếu đến đối tượng lưu trữ phiên dùng để lưu dữ liệu chỉ có thể được truy cập bởi nguồn gốc đã tạo ra nó.

Window.sharedStorage Read only Secure context Deprecated

Trả về đối tượng WindowSharedStorage cho origin hiện tại. Đây là điểm vào chính để ghi dữ liệu vào shared storage bằng Shared Storage API.

Window.speechSynthesis Read only

Trả về đối tượng SpeechSynthesis, là điểm vào để dùng chức năng tổng hợp giọng nói của Web Speech API.

Window.statusbar Read only

Trả về đối tượng statusbar.

Window.toolbar Read only

Trả về đối tượng toolbar.

Window.top Read only

Trả về tham chiếu đến cửa sổ cao nhất trong hệ thống phân cấp cửa sổ. Thuộc tính này chỉ đọc.

Window.trustedTypes Read only

Trả về đối tượng TrustedTypePolicyFactory gắn với đối tượng toàn cục, cung cấp điểm vào để dùng Trusted Types API.

Window.viewport Experimental Read only

Trả về một thể hiện đối tượng Viewport, cung cấp thông tin về trạng thái hiện tại của khung nhìn thiết bị.

Window.visualViewport Read only

Trả về đối tượng VisualViewport đại diện cho khung nhìn trực quan của một cửa sổ.

Window.window Read only

Trả về tham chiếu đến cửa sổ hiện tại.

window[0], window[1], v.v.

Trả về tham chiếu đến đối tượng window trong các khung. Xem thêm Window.frames.

Thuộc tính có tên

Một số phần tử trong tài liệu cũng được bộc lộ như thuộc tính của window:

  • Với mỗi phần tử <embed>, <form>, <iframe>, <img>, và <object>, tên name của nó (nếu không rỗng) sẽ được bộc lộ. Ví dụ, nếu tài liệu chứa <form name="my_form">, thì window["my_form"] (và tương đương window.my_form) trả về tham chiếu đến phần tử đó.
  • Với mỗi phần tử HTML, id của nó (nếu không rỗng) sẽ được bộc lộ.

Nếu một thuộc tính tương ứng với một phần tử duy nhất, phần tử đó sẽ được trả về trực tiếp. Nếu một thuộc tính tương ứng với nhiều phần tử, thì một HTMLCollection chứa tất cả chúng sẽ được trả về. Nếu bất kỳ phần tử nào là một <iframe> hoặc <object> có thể điều hướng, thì thay vào đó sẽ trả về contentWindow của iframe đầu tiên như vậy.

Thuộc tính đã lỗi thời

Window.event Deprecated Read only

Trả về sự kiện hiện tại, tức là sự kiện đang được xử lý bởi ngữ cảnh mã JavaScript, hoặc undefined nếu hiện không có sự kiện nào đang được xử lý. Nên dùng trực tiếp đối tượng Event được truyền đến các bộ xử lý sự kiện khi có thể.

Window.external Deprecated Read only

Trả về một đối tượng với các hàm để thêm nhà cung cấp tìm kiếm bên ngoài cho trình duyệt.

Window.orientation Deprecated Read only

Trả về hướng của khung nhìn theo độ, theo bước 90 độ, tương đối với hướng tự nhiên của thiết bị.

Window.status Deprecated

Lấy/đặt văn bản trong statusbar ở cuối trình duyệt.

Phương thức instance

Giao diện này kế thừa các phương thức từ EventTarget.

Window.atob()

Giải mã một chuỗi dữ liệu đã được mã hóa bằng base-64.

Window.alert()

Hiển thị hộp thoại cảnh báo.

Window.blur() Deprecated

Đưa tiêu điểm ra khỏi cửa sổ.

Window.btoa()

Tạo một chuỗi ASCII được mã hóa base-64 từ một chuỗi dữ liệu nhị phân.

Window.cancelAnimationFrame()

Cho phép hủy một callback đã được lên lịch trước đó với Window.requestAnimationFrame.

Window.cancelIdleCallback()

Cho phép hủy một callback đã được lên lịch trước đó với Window.requestIdleCallback.

Window.clearInterval()

Hủy việc thực thi lặp lại đã được thiết lập bằng Window.setInterval().

Window.clearTimeout()

Hủy việc thực thi trì hoãn đã được thiết lập bằng Window.setTimeout().

Window.close()

Đóng cửa sổ hiện tại.

Window.confirm()

Hiển thị một hộp thoại với thông điệp mà người dùng cần phản hồi.

Window.createImageBitmap()

Nhận vào nhiều loại nguồn ảnh khác nhau và trả về một Promise sẽ được giải quyết thành một ImageBitmap. Tùy chọn, nguồn có thể được cắt theo hình chữ nhật pixel bắt đầu tại (sx, sy) với chiều rộng sw và chiều cao sh.

Window.dump() Non-standard

Ghi một thông điệp ra console.

Window.fetch()

Bắt đầu quá trình lấy một tài nguyên từ mạng.

Window.fetchLater() Experimental

Tạo một yêu cầu fetch trì hoãn, được gửi sau khi trang được điều hướng rời đi, hoặc sau khi hết thời gian activateAfter được cung cấp, tùy điều kiện nào đến trước.

Window.find() Non-standard

Tìm một chuỗi cho trước trong cửa sổ.

Window.focus()

Đặt tiêu điểm vào cửa sổ hiện tại.

Window.getComputedStyle()

Lấy style tính toán cho phần tử được chỉ định. Style tính toán biểu thị các giá trị đã tính của tất cả thuộc tính CSS của phần tử.

Window.getDefaultComputedStyle() Non-standard

Lấy style tính toán mặc định cho phần tử được chỉ định, bỏ qua stylesheet của tác giả.

Window.getScreenDetails() Experimental Secure context

Trả về một Promise sẽ hoàn tất với một thể hiện đối tượng ScreenDetails đại diện cho thông tin về tất cả màn hình có sẵn của thiết bị người dùng.

Window.getSelection()

Trả về đối tượng selection đại diện cho mục đã chọn.

Window.matchMedia()

Trả về một đối tượng MediaQueryList đại diện cho chuỗi truy vấn media đã chỉ định.

Window.moveBy()

Di chuyển cửa sổ hiện tại theo một khoảng được chỉ định.

Window.moveTo()

Di chuyển cửa sổ đến các tọa độ được chỉ định.