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 JavaScript và Tà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() và 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ổ.
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.cachesRead only Secure context-
Trả về đối tượng
CacheStoragegắ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.clientInformationRead only-
Một bí danh của
Window.navigator. Window.closedRead only-
Cho biết cửa sổ hiện tại đã được đóng hay chưa.
-
Trả về tham chiếu đến đối tượng
CookieStorecho ngữ cảnh tài liệu hiện tại. Window.credentiallessRead 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.crossOriginIsolatedRead 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.cryptoRead only-
Trả về đối tượng
Cryptogắn với đối tượng toàn cục. Window.customElementsRead 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.devicePixelRatioRead 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.documentRead only-
Trả về tham chiếu đến tài liệu mà cửa sổ đang chứa.
Window.documentPictureInPictureRead 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.fenceRead only Experimental-
Trả về một thể hiện đối tượng
Fencecho 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.frameElementRead 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.framesRead only-
Trả về một mảng các khung con trong cửa sổ hiện tại.
Window.fullScreenNon-standard-
Cho biết cửa sổ có đang được hiển thị ở chế độ toàn màn hình hay không.
Window.historyRead only-
Trả về tham chiếu đến đối tượng history.
Window.indexedDBRead 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.innerHeightRead 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.innerWidthRead 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.isSecureContextRead 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.launchQueueRead only Experimental-
Khi một ứng dụng web tiến bộ (PWA) được khởi chạy với giá trị
client_modecủalaunch_handlerlàfocus-existing,navigate-new, hoặcnavigate-existing,launchQueuecung cấp truy cập đến lớpLaunchQueue, cho phép triển khai xử lý điều hướng khởi chạy tùy biến cho PWA. Window.lengthRead only-
Trả về số lượng khung trong cửa sổ. Xem thêm
window.frames. Window.localStorageRead 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.locationbarRead only-
Trả về đối tượng locationbar.
-
Trả về đối tượng menubar.
Window.mozInnerScreenXRead 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.mozInnerScreenYRead 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ổ.
-
Trả về đối tượng
Navigationgắn vớiwindowhiện tại. Đây là điểm vào của Navigation API. -
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.originRead only-
Trả về origin của đối tượng toàn cục, được tuần tự hóa thành chuỗi.
Window.originAgentClusterRead only-
Trả về
truenếu cửa sổ này thuộc về một cụm tác tử được khóa theo origin. Window.outerHeightRead only-
Trả về chiều cao của phần hiển thị bên ngoài của cửa sổ.
Window.outerWidthRead only-
Trả về chiều rộng của phần hiển thị bên ngoài của cửa sổ.
Window.parentRead only-
Trả về tham chiếu đến cửa sổ cha.
Window.performanceRead only-
Trả về đối tượng
Performancecho phép đo thời gian và hiệu năng. Window.personalbarRead only-
Trả về đối tượng personalbar.
Window.screenRead only-
Trả về đối tượng screen.
Window.screenXvàWindow.screenLeftRead 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.screenYvàWindow.screenTopRead 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.scrollbarsRead only-
Trả về đối tượng scrollbars.
Window.scrollMaxXNon-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.scrollMaxYNon-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.scrollXRead only-
Trả về số pixel mà tài liệu đã được cuộn theo chiều ngang.
Window.scrollYRead only-
Trả về số pixel mà tài liệu đã được cuộn theo chiều dọc.
Window.selfRead 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ó.
-
Trả về đối tượng
WindowSharedStoragecho 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.speechSynthesisRead 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.statusbarRead only-
Trả về đối tượng statusbar.
Window.toolbarRead only-
Trả về đối tượng toolbar.
Window.topRead 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.trustedTypesRead only-
Trả về đối tượng
TrustedTypePolicyFactorygắn với đối tượng toàn cục, cung cấp điểm vào để dùng Trusted Types API. Window.viewportExperimental 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.visualViewportRead 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.windowRead 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
windowtrong các khung. Xem thêmWindow.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ênnamecủ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 đươngwindow.my_form) trả về tham chiếu đến phần tử đó. - Với mỗi phần tử HTML,
idcủ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
HTMLCollectionchứ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ềcontentWindowcủa iframe đầu tiên như vậy. - Với mỗi phần tử
Thuộc tính đã lỗi thời
Window.eventDeprecated 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
undefinednế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ượngEventđược truyền đến các bộ xử lý sự kiện khi có thể. Window.externalDeprecated 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.orientationDeprecated 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.statusDeprecated-
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
Promisesẽ được giải quyết thành mộtImageBitmap. 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
Promisesẽ hoàn tất với một thể hiện đối tượngScreenDetailsđạ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.