JavaScript. Подробное руководство, 6-е издание
вернуться

Флэнаган Дэвид
Шрифт:

string btoa(string btoa)

Эта вспомогательная функция принимает двоичную строку (в которой каждый символ представлен единственным байтом) и возвращает ее в формате base64. Создать двоичную строку из произвольной последовательности байтов можно с помощью метода

String.fromCharCode.
См. также atob.

void clearInterval(long handle)

Метод

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

void clearTimeout(long handle)

Метод

clearTimeout
отменяет выполнение программного кода, отложенное методом
setTimeout.
Аргумент handle - это значение, возвращаемое вызовом
setTimeout
и идентифицирующее блок программного кода, отложенное исполнение которого отменяется.

void close

Метод

close
закрывает окно верхнего уровня, относительно которого он был вызван. Закрыты могут быть только те окна, которые были открыты JavaScript-сценарием.

boolean confirm(string message)

Выводит сообщение message в диалоговом окне, содержащем кнопки OК и Cancel (Отмена), с помощью которых пользователь должен ответить на вопрос. Если пользователь щелкнет на кнопке OК, метод

confirm
вернет true. Если пользователь щелкнет на кнопке Cancel, метод
confirm
вернет false.

void focus

Передает фокус ввода окну верхнего уровня, соответствующему объекту

Window
. На большинстве платформ при получении фокуса окно верхнего уровня перемещается на вершину стека окон.

CSSStyleDeclaration getComputedStyle(Element elt, [string pseudoElt])

Элемент документа может получать информацию о стиле из встроенного атрибута

style
и из произвольного числа каскадных таблиц стилей. Прежде чем элемент будет отображен в окне, информация о стилях для этого элемента должна быть извлечена из каскадных таблиц стилей, а величины, выражаемые в относительных единицах (таких как проценты или «ems»), должны быть «вычислены» и преобразованы в абсолютные значения. Эти вычисленные значения иногда называют «используемыми» значениями.

Данный метод возвращает доступный только для чтeния oбъeкт

CSSStyleDeclaration
, который представляет эти вычисленные CSS-стили, фактически используемые при отображении элементов. Все размеры в этих стилях выражены в пикселах. Второй аргумент при вызове этого метода обычно опускается или в нем передается значение null, однако в нем можно также передать псевдоэлемент CSS «::before» или «::after», чтобы определить стили для содержимого.

Сравните метод

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

Этот метод не реализован в ІE версии 8 и ниже, но аналогичная функциональность доступна через нестандартное свойство

currentStyle
, имеющееся у каждого объекта
HTMLElement
.

Window open([string url], [string target], [string features], [string replace])

Метод

open
загружает и отображает документ с адресом url в новом или существующем окне или вкладке. Аргумент url определяет URL-адрес документа, который требуется загрузить. Если он не указан, используется адрес «about:blank». Аргумент target определяет имя окна, в которое требуется загрузить документ с адресом url. Если не указан, используется значение «blank». Если аргумент target имеет значение «_Ыаnк», или если окно с указанным именем не найдено, для отображения документа с адресом url будет создано новое окно с указанным именем. Аргумент features используется для определения позиции окна, размеров и других особенностей (таких как необходимость отображения строки меню, панелей инструментов и так далее). В современных броузерах, поддерживающих вкладки, этот аргумент обычно игнорируется и поэтому не описывается здесь.

При использовании метода

Window.open
для загрузки нового документа в существующее окно методу можно передать аргумент replace, определяющий, должна ли для нового документа создаваться новая запись в истории просмотра окна или URL-адрес документа должен заменить текущую запись. Если аргумент replace равен true, то URL-адрес нового документа заменяет старую запись. Если этот аргумент равен false или не указан, то URL-адрес нового документа добавляется в историю просмотра окна в качестве новой записи. Этот аргумент обеспечивает методу функциональность, во многом схожую с функциональностью метода Location. replace.

void postMessage(any message, string targetOrigin, [MessagePort[] ports])

Посылает данному окну копию сообщения message в порты ports, но только если документ, отображаемый в данном окне, имеет происхождение targetOrigin.

В аргументе message можно передать любой объект, который можно скопировать с применением алгоритма структурированного копирования (врезка «Структурированные копии» в главе 22). Аргумент targetOrigin должен быть абсолютным URL-адресом, содержащим протокол, имя хоста и порт, которые определяют требуемое происхождение. Если происхождение не имеет значения, в аргументе targetOrigin можно передать строку «*», а чтобы указать собственное происхождение сценария - строку «/». Вызов этого метода генерирует событие «message» в окне. См. также MessageEvent и раздел 22.3.