Окно

package js.html

extends EventTarget

Доступно в js

Интерфейс Window представляет собой окно, содержащее DOM-документ; свойство document указывает на DOM-документ, загруженный в этом окне.

Документация Окно от Mozilla Contributors, лицензирована по CC-BY-SA 2.5.

См. также:

• https://developer.mozilla.org/en-US/docs/Web/API/Window

Переменные

read onlycaches:CacheStorage

read onlyclosed:Bool

Это свойство указывает, закрыто ли текущее окно или нет.

read onlyconsole:ConsoleInstance

Возвращает ссылку на объект консоли, который предоставляет доступ к консоли отладки браузера.

read onlycontent:Dynamic

Возвращает ссылку на элемент содержимого в текущем окне. Начиная с Firefox 57 (изначально только в Nightly), обе версии доступны только из кода Chrome (привилегированного), а не для веб-страницы.

read onlycrypto:Crypto

Возвращает объект шифрования браузера.

read onlydevicePixelRatio:Float

Возвращает отношение между физическими пикселями и пикселями независимыми от устройства в текущем отображении.

read onlydocument:HTMLDocument

Возвращает ссылку на документ, содержащийся в окне.

read onlyevent:Dynamic

Возвращает текущее событие, обрабатываемое кодом JavaScript в текущем контексте, или undefined, если в данный момент не обрабатывается ни одно событие. Вместо этого, следует использовать объект Event, передаваемый непосредственно обработчикам событий, когда это возможно.

read onlyframeElement:Element

Возвращает элемент, в который вложено окно, или null, если окно не вложено.

read onlyframes:Window

Возвращает массив подрамков в текущем окне.

fullScreen:Bool

Это свойство указывает, отображается ли окно в полноэкранном режиме или нет.

read onlyhistory:History

Возвращает ссылку на объект истории.

read onlyindexedDB:Factory

innerHeight:Dynamic

Получает высоту области содержимого окна браузера, включая, если отрисовано, горизонтальную полосу прокрутки.

innerWidth:Dynamic

Получает ширину области содержимого окна браузера, включая, если отрисовано, вертикальную полосу прокрутки.

read onlyisSecureContext:Bool

Указывает, может ли контекст использовать функции, требующие защищённых контекстов.

read onlylength:Int

Возвращает количество фреймов в окне. См. также window.frames.

read onlylocalStorage:Storage

Возвращает ссылку на объект локального хранилища, используемый для хранения данных, к которым может получить доступ только источник, создавший его.

read onlylocation:Location

Получает/устанавливает местоположение или текущий URL объекта окна.

read onlylocationbar:BarProp

Возвращает объект locationbar, видимость которого можно переключать в окне.

read onlymenubar:BarProp

Возвращает объект menubar, видимость которого можно переключать в окне.

name:String

Получает/устанавливает имя окна.

read onlynavigator:Navigator

Возвращает ссылку на объект навигатора.

onabort:Function

onabsolutedeviceorientation:Function

onafterprint:Function

onanimationcancel:Function

onanimationend:Function

onanimationiteration:Function

onanimationstart:Function

onauxclick:Function

onbeforeprint:Function

onblur:Function

oncanplay:Function

oncanplaythrough:Function

onchange:Function

onclick:Function

onclose:Function

oncontextmenu:Function

ondblclick:Function

ondevicelight:Function

ondevicemotion:Function

ondeviceorientation:Function

ondeviceproximity:Function

ondrag:Function

ondragend:Function

ondragenter:Function

ondragexit:Function

ondragleave:Function

ondragover:Function

ondragstart:Function

ondrop:Function

ondurationchange:Function

onemptied:Function

onended:Function

onfocus:Function

ongotpointercapture:Function

onhashchange:Function

oninput:Function

oninvalid:Function

onkeydown:Function

onkeypress:Function

onkeyup:Function

onlanguagechange:Function

onload:Function

onloadeddata:Function

onloadedmetadata:Function

onloadend:Function

onloadstart:Function

onlostpointercapture:Function

onmessage:Function

onmessageerror:Function

onmousedown:Function

onmouseenter:Function

onmouseleave:Function

onmousemove:Function

onmouseout:Function

onmouseover:Function

onmouseup:Function

onoffline:Function

ononline:Function

onorientationchange:Function

onpagehide:Function

onpageshow:Function

onpause:Function

onplay:Function

onplaying:Function

onpointercancel:Function

onpointerdown:Function

onpointerenter:Function

onpointerleave:Function

onpointermove:Function

onpointerout:Function

onpointerover:Function

onpointerup:Function

onpopstate:Function

onprogress:Function

onratechange:Function

onreset:Function

onresize:Function

onscroll:Function

onseeked:Function

onseeking:Function

onselect:Function

onselectstart:Function

onshow:Function

onstalled:Function

onstorage:Function

onsubmit:Function

onsuspend:Function

ontimeupdate:Function

ontoggle:Function

ontouchcancel:Function

ontouchend:Function

ontouchmove:Function

ontouchstart:Function

ontransitioncancel:Function

ontransitionend:Function

ontransitionrun:Function

ontransitionstart:Function

onunload:Function

onuserproximity:Function

onvolumechange:Function

onwaiting:Function

onwebkitanimationend:Function

onwebkitanimationiteration:Function

onwebkitanimationstart:Function

onwebkittransitionend:Function

onwheel:Function

opener:Dynamic

Возвращает ссылку на окно, открывшее текущее окно.

read onlyorientation:Int

Возвращает ориентацию в градусах (с шагом 90 градусов) области просмотра относительно естественной ориентации устройства.

read onlyorigin:String

outerHeight:Dynamic

Получает высоту внешней области окна браузера.

outerWidth:Dynamic

Получает ширину внешней области окна браузера.

read onlypageXOffset:Float

Псевдоним для window.scrollX.

read onlypageYOffset:Float

Псевдоним для window.scrollY

read onlyparent:Window

Возвращает ссылку на родительское окно или фрейм.

read onlyperformance:Performance

Возвращает объект Performance, который включает атрибуты Performance.timing и Performance.navigation, каждый из которых является объектом, предоставляющим данные о производительности. См. также Использование тайминга навигации для дополнительной информации и примеров.

read onlypersonalbar:BarProp

Возвращает объект personalbar, видимость которого можно переключать в окне.

read onlyscreen:Screen

Возвращает ссылку на объект screen, связанный с окном.

screenX:Dynamic

Возвращает горизонтальное расстояние от левой границы браузера пользователя до левой стороны экрана.

screenY:Dynamic

Возвращает вертикальное расстояние от верхней границы браузера пользователя до верхней стороны экрана.

read onlyscrollMaxX:Int

Максимальное смещение, до которого можно прокрутить окно по горизонтали, это ширина документа минус ширина области просмотра.

read onlyscrollMaxY:Int

Максимальное смещение, до которого можно прокрутить окно по вертикали (т. е. высота документа минус высота области просмотра).

read onlyscrollX:Float

Возвращает количество пикселей, на которое документ уже был прокручен по горизонтали.

read onlyscrollY:Float

Возвращает количество пикселей, на которое документ уже был прокручен по вертикали.

read onlyscrollbars:BarProp

Возвращает объект scrollbars, видимость которого можно переключать в окне.

read onlyself:Window

Возвращает ссылку на сам объект окна.

read onlysessionStorage:Storage

Возвращает ссылку на объект сессионного хранилища, используемый для хранения данных, к которым может получить доступ только источник, который его создал.

read onlyspeechSynthesis:SpeechSynthesis

Возвращает объект SpeechSynthesis, который является точкой входа для использования функциональности синтеза речи Web Speech API.

status:String

Получает/устанавливает текст в строке состояния в нижней части браузера.

read onlystatusbar:BarProp

Возвращает объект statusbar, видимость которого можно переключать в окне.

read onlytoolbar:BarProp

Возвращает объект toolbar, видимость которого можно переключать в окне.

read onlytop:Window

Возвращает ссылку на верхнее окно в иерархии окон. Этот свойство является только для чтения.

read onlywindow:Window

Возвращает ссылку на текущее окно.

onbeforeunload:Event ‑> Null<String>

onerror:(EitherType<Event, String>, String, Int, Int, Dynamic) ‑> Dynamic

Методы

alert(message:String):Void

alert():Void

Отображает диалоговое окно с предупреждением.

Выбрасывает:

atob(atob:String):String

Выбрасывает:

blur():Void

Убирает фокус с окна.

Выбрасывает:

btoa(btoa:String):String

Выбрасывает:

cancelAnimationFrame(handle:Int):Void

Позволяет отменить обратный вызов, ранее запланированный с помощью Window.requestAnimationFrame.

Выбрасывает:

captureEvents():Void

Регистрирует окно для захвата всех событий указанного типа.

clearInterval(handle:Int = 0):Void

clearTimeout(handle:Int = 0):Void

close():Void

Закрывает текущее окно.

Выбрасывает:

confirm(message:String = ""):Bool

Отображает диалоговое окно с сообщением, на которое пользователь должен ответить.

Выбрасывает:

createImageBitmap(aImage:ImageElement, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:VideoElement):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasElement):Promise<ImageBitmap>

createImageBitmap(aImage:Blob):Promise<ImageBitmap>

createImageBitmap(aImage:ImageData):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasRenderingContext2D):Promise<ImageBitmap>

createImageBitmap(aImage:ImageBitmap):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBufferView):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBuffer):Promise<ImageBitmap>

createImageBitmap(aImage:VideoElement, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasElement, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:Blob, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ImageData, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasRenderingContext2D, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ImageBitmap, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBufferView, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBuffer, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

createImageBitmap(aImage:VideoElement, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasElement, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:Blob, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ImageData, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:CanvasRenderingContext2D, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ImageBitmap, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBufferView, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ArrayBuffer, aOffset:Int, aLength:Int, aFormat:ImageBitmapFormat, aLayout:Array<ChannelPixelLayout>):Promise<ImageBitmap>

createImageBitmap(aImage:ImageElement):Promise<ImageBitmap>

createImageBitmap(aImage:ImageElement, aSx:Int, aSy:Int, aSw:Int, aSh:Int):Promise<ImageBitmap>

Выбрасывает:

dump(str:String):Void

Записывает сообщение в консоль.

fetch(input:Request, ?init:Null<RequestInit>):Promise<Response>

fetch(input:String, ?init:Null<RequestInit>):Promise<Response>

find(str:String = "", caseSensitive:Bool = false, backwards:Bool = false, wrapAround:Bool = false, wholeWord:Bool = false, searchInFrames:Bool = false, showDialog:Bool = false):Bool

Ищет заданную строку в окне.

Выбрасывает:

focus():Void

Устанавливает фокус на текущем окне.

Выбрасывает:

getComputedStyle(elt:Element, pseudoElt:String = ""):CSSStyleDeclaration

Получает вычисленный стиль для указанного элемента. Вычисленный стиль указывает вычисленные значения всех свойств CSS элемента.

Выбрасывает:

getDefaultComputedStyle(elt:Element, pseudoElt:String = ""):CSSStyleDeclaration

Получает значение вычисленного стиля по умолчанию для указанного элемента, игнорируя таблицы стилей автора.

Выбрасывает:

getSelection():Selection

Возвращает объект selection, представляющий выбранный(ые) элемент(ы).

Выбрасывает:

matchMedia(query:String):MediaQueryList

Возвращает объект MediaQueryList, представляющий заданную строку медиа-запроса.

Выбрасывает:

moveBy(x:Int, y:Int):Void

Перемещает текущее окно на указанное количество.

Выбрасывает:

moveTo(x:Int, y:Int):Void

Перемещает окно в указанные координаты.

Выбрасывает:

open(url:String = "", target:String = "", features:String = ""):Window

Открывает новое окно.

Выбрасывает:

postMessage(message:Dynamic, targetOrigin:String, ?transfer:Array<Dynamic>):Void

Обеспечивает безопасный способ отправки строки данных из одного окна в другое окно, которое не обязательно должно находиться в том же домене, что и первое.

Выбрасывает:

print():Void

Открывает диалоговое окно печати для печати текущего документа.

Выбрасывает:

prompt(message:String = "", default_:String = ""):String

Возвращает текст, введенный пользователем в диалоговом окне ввода.

Выбрасывает:

releaseEvents():Void

Освобождает окно от захвата событий определенного типа.

requestAnimationFrame(callback:Float ‑> Void):Int

Сообщает браузеру, что анимация выполняется, запрашивая у браузера запланировать перерисовку окна для следующего кадра анимации.

Возможные исключения:

resizeBy(x:Int, y:Int):Void

Изменяет размер текущего окна на определенное значение.

Возможные исключения:

resizeTo(x:Int, y:Int):Void

Динамически изменяет размер окна.

Возможные исключения:

scroll(?options:Null<ScrollToOptions>):Void

scroll(x:Float, y:Float):Void

Прокручивает окно до определённого места в документе.

scrollBy(?options:Null<ScrollToOptions>):Void

scrollBy(x:Float, y:Float):Void

Прокручивает документ в окне на указанное количество.

scrollByLines(numLines:Int, ?options:Null<ScrollOptions>):Void

Прокручивает документ на указанное количество строк.

scrollByPages(numPages:Int, ?options:Null<ScrollOptions>):Void

Прокручивает текущий документ на заданное количество страниц.

scrollTo(?options:Null<ScrollToOptions>):Void

scrollTo(x:Float, y:Float):Void

Прокручивает до определённых координат в документе.

setInterval(handler:String, timeout:Float = 0, unused:Rest<Dynamic>):Int

setInterval(handler:Function, timeout:Float = 0, arguments:Rest<Dynamic>):Int

Возможные исключения:

setResizable(resizable:Bool):Void

Включает или отключает возможность пользователя изменять размер окна.

setTimeout(handler:String, timeout:Float = 0, unused:Rest<Dynamic>):Int

setTimeout(handler:Function, timeout:Float = 0, arguments:Rest<Dynamic>):Int

Возможные исключения:

sizeToContent():Void

Изменяет размер окна в соответствии с его содержимым.

Возможные исключения:

stop():Void

Этот метод останавливает загрузку окна.

Возможные исключения:

updateCommands(action:String, ?sel:Selection, reason:Int = 0):Void

Обновляет состояние команд текущего окна браузера (UI).