Window¶
Окно, вкладка или фрейм веб-броузера.
Глобальный объект.
Все методы этого объекта, неявным образом достпны в JavaScript.
- class
Window
()¶ Наследник
EventTarget()
function test(){ alert(x); } window.onload = function() { var x = 10; test(); }
-
applicationCache
¶ Ссылка на
ApplicationCache
-
defaultStatus
¶
-
dialogArguments
¶ В объектах Window, созданных методом showModalDialog(), это свойство хранит значение аргумента arguments, переданного методу showModalDialog(). В обычных объектах Window это свойство отсутствует.
-
event
¶ Только для IE. Cссылается на объект Event, содержащий сведения о самом последнем произошедшем в окне событии. В IE версии 8 и ниже объект со бытия не всегда передается обработчикам событий, и поэтому иногда его приходится извлекать из этого свойства.
-
frameElement
¶ Если данный объект Window находится внутри элемента <iframe>, это свойство будет ссылаться на представляющий его объект IFrame. В окнах верхнего уровня это свойство имеет значение null.
-
frames
¶ Массив фреймов страницы
-
innerWidth, innerHeight
Размеры видимой области окна
-
length
¶ Количество фреймов, содержащихся в данном окне.
-
localStorage
¶ Ссылка на объект
LocalStorage
-
name
¶ Имя окна. Имя может быть задано при создании окна методом open() или в виде значения атрибута name в теге <frame>. Имя окна может использоваться в качестве значения атрибута target в теге <a> или <form>. При таком применении атрибут target указывает, что документ, загружаемый по гиперссылке, или результаты отправки данных формы должны отображаться в указанном окне.
Ссылка на объект
Navigator
-
onafterprint
¶ После вывода содержимого окна на печать
-
onbeforeprint
¶ Перед выводом содержимого окна на печать
-
onbeforeunload
¶ Перед тем как броузер покинет текущую страницу.
Если возвращает строку или присваивает строку свойству returnValue объекта события, эта строка будет выведена в диалоге подтверждения.
window.addEventListener('beforeunload', () => { event.preventDefault(); event.returnValue = ''; });
-
onblur
¶ Когда окно теряет фокус ввода
-
onerror
¶ Когда возникает ошибка в JavaScript-сценарии.
-
onfocus
¶ Когда окно получает фокус ввода
-
onhashchange
¶ Когда идентификатор фрагмента (см. Location.hash) документа изменяется в результате перемещения по истории посещений (см. HashChangeEvent)
-
onLoad
¶ Когда документ и все внешние ресурсы будут загружены полностью
-
onmessage
¶ Когда сценарий в другом окне отправит сообщение вызовом метода post-Message(). См. MessageEvent.
-
onoffline
¶ Когда броузер потеряет соединение с Интернетом
-
ononline
¶ Когда броузер восстановит соединение с Интернетом
-
onpagehide
¶ Перед началом процедуры сохранения страницы в кэше и замещения ее другой страницей
-
onpageshow
¶ Когда страница загружается впервые, событие «pageshow» возбуждается сразу после события «load», при этом свойство persisted объекта события имеет значение false. Однако когда ранее загруженная страница восстанавливается из кэша броузера, размещенного в памяти, событие «load» не возбуждается (поскольку страница в кэше считается уже загруженной), а событие «pageshow» возбуждается с объектом события, свойство persisted которого имеет значение true. См. PageTransitionEvent.
-
onpopstate
¶ Обработчик загрузки новой страницы или восстанавливание состояния, сохраненное с помощью метода History.pushState() или History.replaceState()
window.onpopstate = function(){ ... };
-
onresize
¶ Когда пользователь изменяет размер окна броузера
-
onscroll
¶ Когда пользователь прокручивает окно броузера
-
onstorage
¶ Когда изменяется содержимое localStorage или sessionStorage. См. StorageEvent.
-
onunload
¶ Броузер покинул страницу. Обратите внимание: если страница зарегистрирует обработчик события onunload, она не будет сохраняться в кэше. Чтобы обеспечить быстрый возврат к странице без повторной ее загрузки, следует использовать обработчик onpagehide.
-
opener
¶ Доступная для чтения и записи ссылка на объект Window, в котором содержится сценарий, вызвавший метод open() для открытия в броузере окна верхнего уровня, или null в окнах, созданных иным способом. Это свойство действительно только для объектов Window, представляющих окна верхнего уровня, но не для объектов, представляющих фреймы. Свойство opener может использоваться во вновь создан ном окне для доступа к свойствам и методам создавшего его окна.
-
outerHeight
¶
-
outerWidth
¶ Эти свойства определяют общую высоту и ширину окна броузера в пикселах. Эти размеры включают высоту и ширину строки меню, панелей инструментов, полос прокрутки, рамок окна и тому подобное. Эти свойства не поддерживаются в IE версии 8 и ниже.
-
pageXOffset
¶
-
pageYOffset
¶ Число пикселов, на которые текущий документ был прокручен вправо (pageXOffset) и вниз (pageYOffset). Эти свойства не поддерживаются в IE версии 8 и ниже. Порядок использования этих свойств и совместимый программный код, действующий в IE, демонстрируются в примере 15.8.
-
parent
¶ Объект Window, содержащий данное окно. Если данное окно является окном верхнего уровня, parent ссылается на само окно. Если данное окно является фреймом, свойство parent ссылается на окно или фрейм, в котором содержится данное окно.
-
returnValue
¶ Это свойство отсутствует в обычных окнах, но присутствует в объектах Window, созданных методом showModalDialog(), и по умолчанию содержит пустую строку. Когда окно диалога закрывается (см. описание метода close()), этому свойству присваивается значение, возвращаемое методом showModalDialog().
-
screenLeft, screenTop
Координаты левого верхнего угла, для IE
-
screenX, screenY
Координаты левого верхнего угла, для Firefox
-
self
¶ Ссылка на само окно. Синоним свойства window.
-
sessionStorage
¶ Ссылка на объект
SessionStorage
-
status
¶
-
top
¶ Окно верхнего уровня, содержащее данное окно. Если данное окно является окном верхнего уровня, свойство top содержит ссылку на само окно. Если данное окно представляет собой фрейм, свойство top ссылается на окно верхнего уровня, содержащее данный фрейм. Сравните со свойством parent.
-
URL
¶ На момент написания этих строк данное свойство было ссылкой на объект, определяющий функции, которые были описаны в справочной статье URL. В будущем это свойство может превратиться в конструктор URL() и определять прикладной интерфейс для анализа URL-адресов и строк запроса в них.
-
window
Свойство window идентично свойству self – оно содержит ссылку на данное окно. Поскольку в клиентских сценариях на языке JavaScript объект Window является глобальным объектом, данное свойство позволяет обращаться к глобальному объекту как к глобальной переменной window.
-
addEventListener
(event_type, callback, capture)¶
-
alert
(String text)¶ Выводит информационное окно
window.alert('Hello, ilnurgi');
-
atob
(string atob)¶ Эта вспомогательная функция принимает строку в формате base64 и декодирует ее в двоичную строку, где каждый символ представлен единственным байтом. Извлекать значения байтов из полученной строки можно с помощью ее метода charCodeAt(). См. также btoa()
-
blur
()¶ Метод blur() убирает фокус ввода из окна верхнего уровня, соответствующего объекту Window. Точно не определено, какому окну передается фокус в результате вызова этого метода. В некоторых броузерах и/или на некоторых платформах данный метод может не оказывать никакого эффекта.
-
btoa
(string btoa)¶ Эта вспомогательная функция принимает двоичную строку (в которой каждый символ представлен единственным байтом) и возвращает ее в формате base64. Создать двоичную строку из произвольной последовательности байтов можно с помощью метода String.fromCharCode(). См. также atob().
-
clearInterval
(timer_id), clearTimeout(timer_id)¶ Выключает таймер
-
clearTimeout
(long handle)¶ Метод clearTimeout() отменяет выполнение программного кода, отложенное методом setTimeout(). Аргумент handle – это значение, возвращаемое вызовом setTimeout() и идентифицирующее блок программного кода, отложенное исполнение которого отменяется.
-
close
¶ Закрывает окно
-
confirm
(message)¶ Выводит сообщение message в диалоговом окне, содержащем кнопки OK и Cancel (Отмена), с помощью которых пользователь должен ответить на вопрос.
Если пользователь щелкнет на кнопке OK, метод confirm() вернет true.
Если пользователь щелкнет на кнопке Cancel, метод confirm() вернет false.
let answer = window.confirm('Нравятся котики?'); if (answer) { window.alert('Тебе нравятся котики'); } else { window.alert('Тебе НЕ нравятся котики'); }
-
decodeURI
(str)¶ Декодирует символы в URI
-
decodeURIComponent
(str)¶ Декодирует управляющие последовательности символов в компоненте URI
-
encodeURI
(str)¶ Выполняет кодирование URI с помощью управляющих пос ледовательностей
encodeURI("http://www.isp.com/app.cgi?arg1=1&arg2=hello world"); // http://www.isp.com/app.cgi?arg1=1&arg2=hello%20world encodeURI("\u00a9"); // %C2%A9
-
encodeURIComponent
(str)¶ Кодирование данных
encodeURIComponent('hello & world'); // hello%20%26%20world
-
escape
(str)¶ Кодирует строку
escape("Hello World!"); // Вернет "Hello%20World%21"
-
focus
()¶ Передает фокус ввода окну верхнего уровня, соответствующему объекту Window. На большинстве платформ при получении фокуса окно верхнего уровня перемещается на вершину стека окон.
-
getComputedStyle
(Element elt[, string pseudoElt])¶ Элемент документа может получать информацию о стиле из встроенного атрибута style и из произвольного числа каскадных таблиц стилей. Прежде чем элемент будет отображен в окне, информация о стилях для этого элемента должна быть извлечена из каскадных таблиц стилей, а величины, выражаемые в относительных единицах (таких как проценты или «ems»), должны быть «вычислены» и преобразованы в абсолютные значения. Эти вычисленные значения иногда называют «используемыми» значениями.
Данный метод возвращает доступный только для чтения объект CSSStyleDeclaration, который представляет эти вычисленные CSS-стили, фактически используемые при отображении элементов. Все размеры в этих стилях выражены в пикселах.
Второй аргумент при вызове этого метода обычно опускается или в нем передается значение null, однако в нем можно также передать псевдоэлемент CSS «::before» или «::after», чтобы определить стили для содержимого.
-
isFinite
(obj)¶ Определяет, является ли число конечным
-
isNan
(obj)¶ Возвращает булево, является ли аргумент нечисловым значением
isNaN(0); // false isNaN(0/0); // true isNaN(parseInt("3")); // false isNaN(parseInt("hello")); // true isNaN("3"); // false isNaN("hello"); // true isNaN(true); // false isNaN(undefined); // true
-
open
(url, window_title, window_params)¶ Возвращает ссылку и открывает новое окно в браузере
w = open('ilnurgi.html', 'Window Name', "width=400,height=400,status=yes,resizable=no")
-
parseFloat
(obj)¶ Возвращает числовое представление объекта
parseFloat("74.54"); // 74.54
-
parseInt
(obj[, base=10])¶ Возвращает числовое представление объекта
- Parameters
base – система исчисления
parseInt("18"); // 18 parseInt("19kdjas"); // 19 parseInt("74.54"); // 74 parseInt("ff"); // Nan parseInt("ff", "16"); // 255 parseInt("0x10"); // 16 parseInt("0x10","10"); // 0
-
postMessage
(any message, string targetOrigin[, MessagePort[] ports])¶ Посылает данному окну копию сообщения message в порты ports, но только если документ, отображаемый в данном окне, имеет происхождение targetOrigin.
В аргументе message можно передать любой объект, который можно скопировать с применением алгоритма структурированного копирования. Аргумент targetOrigin должен быть абсолютным URL-адресом, содержащим протокол, имя хоста и порт, которые определяют требуемое происхождение. Если происхождение не имеет значения, в аргументе targetOrigin можно передать строку «*», а чтобы указать собственное происхождение сценария – строку «/». Вызов этого метода генерирует событие «message» в окне.
-
print
()¶ На вызов метода print() броузер реагирует так же, как если бы пользователь выбрал пункт меню или щелкнул на кнопке Print (Печать). Обычно после этого появля ется диалоговое окно, позволяющее отменить операцию печати или выполнить дополнительную настройку.
-
prompt
(message, default_value)¶ Выводит сообщение message в диалоговом окне, содержащем поле ввода и кнопки OK и Cancel, и блокирует работу сценария, пока пользователь не щелкнет на одной из кнопок.
Если пользователь щелкнет на кнопке Cancel, метод вернет null.
Если пользователь щелкнет на кнопке OK, метод вернет значение, указанное в этот момент в поле ввода.
Аргумент default_value определяет начальное содержимое поля ввода.
let userName = window.prompt("Как вас зовут?"); if (userName) { window.alert(`Здравствуй, ${userName}`); }
-
scroll
(long x, long y)¶ Синоним метода scrollTo().
-
scrollBy
(long x, long y)¶ Прокручивает документ, отображаемый в окне, на относительную величину, заданную аргументами x и y.
-
scrollTo
(long x, long y)¶ Прокручивает документ, отображаемый в окне, так, чтобы точка с координатами x и y в документе оказалась в левом верхнем углу, если это возможно.
-
setInterval
(func, time, args)¶ Возвращает индентификатор таймера и запускает функцию в цикле с указанной периодичностью, миллисекунды
-
Window.
setTimeout
(func, time, args)¶ Возвращает идентификатор таймера и запускает функцию через время, миллисекунды
setTimeout(function() { alert('Hello world'); }, 1000);
const user = { name: 'ilnurgi', sayHello: function() { alert(this.name); } }; setTimeout(user.sayHello, 1000); // будет выведено undefined, контекст будет пустой setTimeout(function() { user.sayHello(); }, 1000) // будет выведено ilnurgi setTimeout(user.sayHello.bind(user), 1000) // будет выведено ilnurgi
-
showModalDialog
(string url[, any arguments])¶ Создает новый объект Window, сохраняет значение arguments в свойстве dialogArguments этого объекта, загружает в окно документ с адресом url и блокирует выполнение сценария, пока окно не будет закрыто. После закрытия окна метод возвращает значение свойства returnValue окна.
-
unescape
(str)¶ Декодирует строку
-