Объект верхнего уровня, используемый для доступа к Java-классам пакета netscape.*.
Объект ядра | |
Реализован в | JavaScript 1.1, NES 2.0 |
Любой класс Java-пакета netscape.*.
Свойство из | Packages |
Реализовано в | JavaScript 1.1, NES 2.0 |
Строка, специфицирующая полный URL следующего вхождения из history.
Свойство из | History |
Только для чтения | |
Реализовано в | JavaScript 1.1 |
Даёт возможность работать с числами. Объект Number это оболочка для объектов примитивного типа.
Объект ядра | |
Реализован в | JavaScript 1.1, NES 2.0
JavaScript 1.2: модифицировано поведение конструктора Number.
JavaScript 1.3: добавлен метод toSource. |
Версия ECMA | ECMA-262 |
Object это примитивный тип объекта JavaScript. Все объекты JavaScript являются потомками Object. То есть все объекты JavaScript имеют методы, определённые для Object.
Объект ядра | |
Реализован в |
JavaScript 1.0: метод toString. JavaScript 1.1, NES 2.0: добавлены методы eval и valueOf; свойство constructor. JavaScript 1.2: не рекомендуется использовать метод eval.
JavaScript 1.3: добавлен метод toSource |
Версия ECMA | ECMA-262 |
onMouseUp
onBluronClick
onFocus
Обработчики событий onBlur, onFocus, onLoad и onUnload специфицируются в тэге BODY, но реально являются обработчиками событий объекта window. Вот обработчики событий объекта document:
onClick onDblClick onKeyDown onKeyPress onKeyUp onMouseDown onMouseUpДля определения обработчика события для объекта Image, созданного конструктором Image, установите соответствующее свойство объекта. Например, если у Вас имеется объект Image по имени imageName и Вы хотите установить в один из его обработчиков событий функцию handlerFunction, используйте один из следующих операторов:
imageName.onabort = handlerFunctionОбъекты Image не имеют обработчиков onClick, onMouseOut и onMouseOver. Однако, если Вы определите для изображения объект Area или поместите тэг IMG внутри объекта Link, Вы сможете использовать обработчики событий для объектов Area или Link. См. Link.
Area-объекты имеют следующие обработчики:
onDblClick onMouseOut onMouseOverLink-объекты имеют следующие обработчики:
onClick onDblClick onKeyDown onKeyPress onKeyUp onMouseDown onMouseOut onMouseUp onMouseOveronBlur
onChange
onFocus
onKeyDown
onKeyPress
onKeyUp
onSelect
В JavaScript 1.1, на некоторых платформах, размещение обработчика onBlur или onFocus в тэге FRAMESET не даёт эффекта.
Если Вы специфицируете единственный параметр в конструкторе Array, поведение будет зависеть того, специфицирован ли параметр LANGUAGE="JavaScript1.2" в тэге <SCRIPT>:
Если специфицирован LANGUAGE="JavaScript1.2" в тэге <SCRIPT>, возвращается массив из одного элемента. Например, new Array(5) создаёт одноэлементный массив с первым элементом 5. Конструктор с единственным параметром работает так же, как и конструктор с несколькими параметрами. Вы не можете специфицировать свойство length объекта Array, используя конструктор с единственным параметром.Если LANGUAGE="JavaScript1.2" в тэге <SCRIPT> не специфицирован, Вы указываете начальный размер массива, как и в других версиях JavaScript.Если Вы специфицируете единственный параметр в конструкторе Array, Вы специфицируете начальный размер массива. Следующий код создаёт массив из пяти элементов:
billingMethod = new Array(5)Вы обязаны индексировать массив по порядковому номеру; например, myArray[0].
JavaScript 1.2. Метод splice возвращает удаляемый элемент, если удаляется только один элемент (параметр howMany равен 1); иначе метод возвращает массив, содержащий удалённые элементы.
В JavaScript 1.2 и более ранних версиях метод toString возвращает строку, представляющую исходный код массива. Это то же самое значение, что и возвращаемое методом toSource в JavaScript 1.3 и более поздних версиях.
Если объект Boolean используется как условие в условном тестировании, JavaScript возвращает значение Boolean-объекта. Например, объект Boolean со значением false рассматривается как примитивное значение false, а Boolean-объект со значением true рассматривается как примитивное значение true в условном тестировании. Если Boolean-объект false, условный оператор вычисляется в false.
JavaScript 1.2 и ранее.Поведение объекта Date таково:
Даты до 1970 не допускаются. JavaScript зависит от специфики дат на данной платформе; поведение объекта Date меняется от платформы к платформе.JavaScript 1.2 и ранее. Метод getYear возвращает 2-х или 4-хзначное число - год:
Для лет от 1900 до 1999 включительно - getYear возвращает значение года минус 1900. Например, если это 1976 год, будет возвращено 76.Для лет меньше 1900 или больше 1999 - getYear возвращает год из 4 цифр. Например, если это 1856 год, будет возвращено 1856. Если это 2026 год, будет возвращено значение 2026.JavaScript 1.1 и более ранние версии. Вы не можете вкладывать один оператор функции в другой оператор либо в самого себя.
JavaScript 1.1 и 1.2. Следующие возможности JavaScript1.1 и JavaScript 1.2 удалены:
Каждая локальная переменная функции является свойством массива arguments. Например, если функция myFunc имеет локальную переменную myLocalVar, Вы можете обратиться к переменной arguments.myLocalVar. Каждый формальный аргумент функции является свойством массива arguments. Например, если функция myFunc имеет два аргумента arg1 и arg2, Вы можете обратиться к аргумента arguments.arg1 и arguments.arg2. (Вы можете также обратиться к ним arguments[0] и arguments[1].)JavaScript 1.2. Поведение метода toString зависит от того, специфицирован ли атрибут LANGUAGE="JavaScript1.2" в тэге <SCRIPT>:
Если LANGUAGE="JavaScript1.2" специфицирован в тэге <SCRIPT>, метод toString возвращает литерал объекта. Если LANGUAGE="JavaScript1.2" в тэге <SCRIPT> не специфицирован, метод toString возвращает [object type], как и в других версиях JavaScript.JavaScript 1.2. Метод charCodeAt возвращает число - значение из набора символов ISO-Latin-1 для символа по данному индексу в строке. Диапазон значений для набора ISO-Latin-1 - от 0 до 255. Первые числа от 0 до 127 напрямую соответствуют набору символов ASCII.
JavaScript 1.2. Метод fromCharCode возвращает строку, созданную с использованием специфицированной последовательности значений набора ISO-Latin-1.
Специфицирует, выполняются ли обновления окна в offscreen-буфере.
Свойство из | window |
Реализовано в | JavaScript 1.2 |
Открывает поток для сбора вывода методов write или writeln.
Метод из | document |
Реализован в | JavaScript 1.0 JavaScript 1.1: добавлен параметр "replace"; document.open() или document.open("text/html") очищает текущий документ, если его загрузка закончена. |
Открывает новое окно web-браузера.
Метод из | window |
Реализован в | JavaScript 1.0
JavaScript 1.2: добавлено несколько новых windowFeatures. |
Специфицирует окно вызывающего документа, если окно открывается методом open.
Свойство из | window |
Реализовано в | JavaScript 1.1 |
Автор HTML-страницы обязан разрешить аплету доступ к JavaScript путём специфицирования атрибута MAYSCRIPT в тэге APPLET. Это предотвращает доступ аплета к JavaScript на странице без ведома автора страницы. Например, чтобы разрешить аплету musicPicker.class доступ к JavaScript на Вашей странице, специфицируйте:
<APPLET CODE="musicPicker.class" WIDTH=200 HEIGHT=35Доступ к JavaScript при отсутствии специфицированного атрибута MAYSCRIPT вызывает исключение.
Информацию LiveConnect об использовании аплетов см. дополнительно в книге "Клиентский JavaScript. Руководство по Использованию".
Массив является упорядоченным набором значений, ассоциированных с одним именем переменной.
В этом примере создаётся Array -объект с литералом массива; массив coffees состоит из трёх элементов и имеет размер "три":
coffees = ["French Roast", "Columbian", "Kona"]concat не изменяет начальные массивы, но возвращает копию "на один уровень глубже", содержащую копии элементов, скомбинированные из массивов-оригиналов. Элементы массивов-оригиналов копируются в новый массив таким образом:
Ссылки на объекты (а не реальные объекты): concat копирует ссылки на объекты в новый массив. И массив-оригинал, и новый массив ссылаются на один и тот же объект. Если изменяется оригинальный объект, эти изменения отражаются и в новом массиве, и в массиве-оригинале. Строки и числа (не объекты String и Number): concat копирует строки и числа в новый массив. Изменение строки или числа одного массива не влияет на другие массивы.Если в любой массив добавляется новый элемент, другой массив остаётся без изменений.
Следующий код объединяет два массива:
alpha=new Array("a","b","c")Следующий код объединяет три массива:
num1=[1,2,3]Значением свойства length является целое положительное число со значением, меньшим чем 2 в степени 32 (232).
Вы можете установить свойство length в любое время для усечения массива. Если Вы увеличиваете массив, изменяя его свойство length, реальное количество элементов не увеличивается; например, если Вы устанавливаете length в 3, когда оно в данный момент равно 2, массив будет продолжать содержать только два элемента.
slice не изменяет массив-оригинал, а возвращает новую копию "на один уровень глубже", содержащую копии элементов, извлечённых из массива-оригинала. Элементы массива-оригинала копируются в новый массив так:
Для ссылок на объекты (а не для реальных объектов) slice копирует ссылки на объект в новый массив. Новый и оригинальный массивы ссылаются на один и тот же объект. Если объект, на который ссылаются, изменяется, эти изменения появляются в обоих массивах. Для строк и чисел (не объектов String и Number) slice копирует строки и числа в новый массив. Изменение строки или числа в одном массиве не влияет на другой массив.Если в любой массив добавляется новый элемент, другой массив не изменяется.
Если compareFunction не предоставляется, элементы сортируются путём конвертации их в строки и сравнения строк в лексикографическом порядке ("словарном порядке" или "порядке телефонной книги", а не в числовом порядке). Например, "80" в словарном порядке идёт перед "9", а в числовом 9 идёт перед 80.
Если параметр compareFunction предоставлен, элементы массива сортируются в соответствии с return-значением сравнивающей функции. Если a и b являются сравниваемыми элементами, то:
Если compareFunction(a, b) меньше 0, b сортируется с меньшим индексом, чем a. Если compareFunction(a, b) возвращает 0, a и b не изменяют своего положения друг относительно друга, но сортируются относительно всех других элементов. Если compareFunction(a, b) больше 0, b сортируется с большим индексом, чем a.Итак, функция сравнения имеет следующую форму:
function compare(a, b) {Для сравнения чисел, а не строк, функция сравнения может просто вычитать b из a:
function compareNumbers(a, b) {JavaScript использует стабильную сортировку: относительное расположение a и b не меняется, если a и b равны. Если до сортировки индекс a был меньше, чем индекс b, он будет меньше и после сортировки вне зависимости от того, как a и b будут перемещены в ходе сортировки.
Поведение метода sort различается в версиях JavaScript 1.1 и JavaScript 1.2.
В JavaScript 1.1, на некоторых платформах, метод sort не работает. Этот метод работает на всех платформах в JavaScript 1.2.
В JavaScript 1.2 этот метод больше не конвертирует undefined-элементы в null; вместо этого он сортирует их в конец массива. Например, у вас имеется такой скрипт:
<SCRIPT>В JavaScript 1.1 будет выведено:
ant, null, null, null, null, zebraВ JavaScript 1.2 будет выведено:
ant, undefined, undefined, undefined, undefined, zebraЕсли Вы специфицируете разные количества удаляемых и вставляемых элементов, массив будет иметь по окончании вызова другой размер.
Метод splice возвращает массив, содержащий удалённые элементы. Если удаляется только один элемент, возвращается массив, состоящий из одного элемента.
Метод toSource возвращает следующие значения:
Для встроенного объекта Array метод toSource возвращает следующую строку, указывающую, что исходный код недоступен:function Array() {Этот метод обычно вызывается внутренне в JavaScript, а не явно в коде. Вы можете вызвать toSource при отладке для проверки содержимого массива.
Объект Array переопределяет метод toString из Object. Для Array -объектов метод toString объединяет массив и возвращает одну строку, содержащую все элементы массива, разделённые запятыми. Например, следующий код создаёт массив и использует toString для конвертации массива в строку.
var monthNames = new Array("Jan","Feb","Mar","Apr")JavaScript вызывает метод toString автоматически, когда массив представляется как текстовое значение или когда к массиву обращаются при конкатенации строк.
Объект Array наследует метод valueOf из Object. Метод valueOf объекта Array возвращает примитивное значение массива или примитивное значение его элементов так:
Boolean | Boolean |
Number или Date | number |
Все прочие | string |
Этот метод обычно вызывается в JavaScript внутренне, а не явно в коде.
Не смешивайте примитивные булевы значения true и false со значениями true и false объекта Boolean.
Любой объект со значением undefined или null, включая объект Boolean со значением false, вычисляется в true, когда передаётся в условный оператор. Например, условие следующего оператора if вычисляется в true:
x = new Boolean(false);Это поведение не применяется для булевых примитивов. Например, условие в следующем операторе if вычисляется в false:
x = false;Не используйте объект Boolean для конвертации не-булева значения в булево. Вместо этого используйте Boolean как функцию для выполнения этой задачи:
x = Boolean(выражение) //предпочтительноЕсли Вы специфицируете любой объект, включая объект Boolean со значением false, как начальное значение объекта Boolean, новый Boolean-объект имеет значение true.
myFalse=new Boolean(false) //начальное значение - falseВ JavaScript 1.3 и позднее не используйте объект Boolean вместо булева примитива.
Метод toSource возвращает следующие значения:
Для встроенного объекта Boolean метод toSource возвращает следующую строку, означающую, что исходный код недоступен:function Boolean() {Этот метод обычно вызывается внутренне в JavaScript, а не явно в коде.
Объект Boolean переопределяет метод toString объекта Object; он не наследует метод Object.toString. Для Boolean-объектов метод toString возвращает строку, представляющую объект.
JavaScript вызывает метод toString автоматически, когда Boolean представлен как текстовое значение или когда на Boolean имеется ссылка при конкатенации строк.
Для Boolean -объектов и значений встроенный метод toString возвращает строку "true" или "false", в зависимости от значения Булева объекта. В следующем коде flag.toString возвращает "true".
var flag = new Boolean(true)Метод valueOf объекта Boolean возвращает примитивное значение объекта Boolean или Boolean-литерал как тип данных Boolean.
Этот метод обычно вызывается JavaScript внутренне, а не явно в коде.
Объект Button на форме выглядит так:
Объект Button это элемент формы и обязан быть определён внутри тэга FORM (теперь вроде уже нет - прим перев.).
Объект Button это специальная кнопка, которую можно использовать для выполнения определённой Вами акции. Кнопка выполняет скрипт, специфицированный её обработчиком onClick.
Каждый элемент формы имеет свойство form, то есть ссылку на родительскую форму элемента. Это свойство используется в обработчиках событий, где бывает необходимо обратиться к другому элементу текущей формы.
Свойство name первоначально отражает значение атрибута NAME. Изменение свойства name переопределяет эту установку.
Не путайте свойство name с текстом, отображаемым на поверхности кнопки. Свойство value специфицирует лэйбл кнопки. Свойство name не выводится на экран; оно используется для программного обращения к объекту.
Если несколько объектов формы имеют одно значение атрибута NAME, автоматически создаётся массив с данным именем. Каждый элемент этого массива представляет отдельный Form -объект. Элементы индексируются в порядке их появления в коде, начиная с 0. Например, если два элемента Text и элемент Button в одной форме имеют атрибут NAME со значением "myField", создаётся массив из элементов myField[0], myField[1] и myField[2]. Вы должны учитывать такую ситуацию при создании кода и знать, ссылается myField на единственный элемент или на массив элементов.
Объект Checkbox на форме выглядит так:
Объект Checkbox это элемент формы и он обязан быть определён (теперь вроде уже нет - прим перев.) внутри тэга FORM.
Используйте свойство checked для специфицирования статуса переключателя (включён он или нет). Свойство defaultChecked используется для специфицирования статуса переключателя при загрузке или очистке формы.
Если переключатель выбран (отмечен "птичкой"), значение его свойства checked будет true; иначе - false.
Вы можете в любой момент установить свойство checked. Вид переключателя обновляется немедленно после изменения свойства checked.
Если переключатель отмечен по умолчанию, значение свойства defaultChecked - true; иначе - false.
defaultChecked первоначально отражает использование атрибута CHECKED в тэге INPUT; однако установка defaultChecked переопределяет значение атрибута CHECKED.
Вы можете установить свойство defaultChecked в любой момент. Вид переключателя не изменяется после установки свойства defaultChecked, это происходит только при установке свойства checked.
Метод focus используется для перехода к переключателю и передаче ему фокуса. Тогда пользователь сможет изменять статус переключателя.
Каждый элемент формы имеет свойство form, которое является ссылкой на родительскую форму. Это свойство используется в обработчиках событий, где Вам может понадобиться обратиться к другому элементу текущей формы.
Если несколько объектов формы имеют одно значение атрибута NAME, автоматически создаётся массив с данным именем. Каждый элемент этого массива представляет отдельный Form -объект. Элементы индексируются в порядке их появления в коде, начиная с 0. Например, если два элемента Text и элемент Button в одной форме имеют атрибут NAME со значением "myField", создаётся массив из элементов myField[0], myField[1] и myField[2]. Вы должны учитывать такую ситуацию при создании кода и знать, ссылается myField на единственный элемент или на массив элементов.
Если аргументы не заданы, конструктор создаёт объект Date с текущей датой и временем в соответствии с локальным временем. Если заданы некоторые, но не все, аргументы, отсутствующие аргументы устанавливаются в 0. Если Вы задаёте некоторые аргументы, Вы обязаны как минимум задать значения year, month и day. Можно опустить hours, minutes, seconds и milliseconds.
Дата измеряется в миллисекундах, прошедших с полуночи 01 января 1970 UTC.
В сутках 86,400,000 миллисекунд. Объект Date имеет диапазон от -100,000,000 до 100,000,000 дней относительно 01 January, 1970 UTC.
Объект Date имеет универсальное поведение на всех платформах.
Объект Date поддерживает несколько UTC-методов (универсальных), а также методы локального времени.
UTC, известное также как Greenwich Mean Time (GMT) - время по Гринвичу, это время по стандарту World Time Standard. локальное время это время компьютера, на котором выполняется JavaScript.
Для обеспечения совместимости с переходом в новое тысячелетие Вы должны всегда полностью специфицировать год; например, используйте 1998, а не 98. Для специфицирования полного года JavaScript имеет методы getFullYear, setFullYear, getFullUTCYear и setFullUTCYear.
Следующий пример возвращает время в миллисекундах, прошедшее между датами timeA и timeB.
timeA = new Date();getDay возвращает целое число, соответствующее дню недели: 0 - воскресенье, 1 - понедельник, 2 - вторник и т.д.
getFullYear возвращает абсолютное число. Для дат в диапазоне лет от 1000 до 9999 getFullYear возвращает число из 4 цифр, например, 1995. Используйте эту функцию, чтобы иметь уверенность в соответствии числа для лет после 2000.
Используёте этот метод вместо getYear.
getTime возвращает количество миллисекунд, прошедших после 1 января 1970, 00:00:00. Вы можете использовать этот метод для присвоения даты и времени другому Date -объекту.
Смещение часового пояса это разница между местным временем и Greenwich Mean Time (GMT). Корректировка перехода на летнее время делает это значение неконстантным.
getUTCMonth возвращает целое число в диапазоне от 0 до 11.
0 - январь, 1 -февраль, 2 -март и т.д.
getYear больше не используется и заменён на метод getFullYear.
Метод getYear возвращает год минус 1900; соответственно:
Для лет больше 2000 - возвращаемое методом getYear значение будет 100 или больше. Например, если это 2026 год, getYear возвратит 126. Для лет от 1900 до 1999 включительно - значение, возвращаемое методом getYear, находится в диапазоне от 0 до 99. Например, если это 1976 год, getYear возвращает 76.Для лет меньше 1900 и больше 1999 значение, возвращаемое методом getYear, будет меньше 0. Например, если это 1800 год, getYear возвращает -100.Чтобы учесть годы до и после 2000, Вы должны использовать Date.getFullYear вместо getYear, чтобы был специфицирован полный год.
Метод parse принимает строку с датой (такую как "Dec 25, 1995") и возвращает количество миллисекунд, прошедших до этой даты после 1 января 1970, 00:00:00 (местного времени). Эта функция используется для установки значений даты на основе строковых значений, например, в сочетании с методом setTime и Date -объектом.
Получая строку с временем, parse возвращает значение времени. Он принимает синтаксис даты стандарта IETF : "Mon, 25 Dec 1995 13:30:00 GMT". Он понимает сокращения континентальных часовых поясов США, но для общих случаев используйте смещение часового пояса, например, "Mon, 25 Dec 1995 13:30:00 GMT+0430" (на 4 часа и 30 минут западнее Гринвичского меридиана). Если Вы не специфицируете часовой пояс, используется локальный часовой пояс. GMT и UTC эквивалентны.
Поскольку parse это static-метод объекта Date, Вы всегда используете его как Date.parse(), а не как метод Date -объекта, созданного Вами.
Если параметры monthValue и dayValue не специфицированы, используются значения, возвращаемые методами getMonth и getDate.
Если специфицированные Вами параметры находятся вне пределов ожидаемого диапазона, setFullYear пытается соответствующим образом обновить другие параметры и информацию даты в Date -объекте. Например, если Вы специфицируете 15 для monthValue, год увеличивается на 1 (year + 1), а 3 используется для месяца.
Если Вы не специфицировали параметры minutesValue, secondsValue и msValue, используются значения, возвращаемые методами getUTCMinutes, getUTCSeconds и getMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setHours пытается обновить информацию даты в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты будут увеличены на 1 (min + 1), а 40 будет использовано для секунд.
Если Вы специфицируете число вне пределов ожидаемого диапазона, информация даты в Date -объекте обновляется соответствующим образом. Например, если Вы специфицировали 1005, количество секунд увеличивается на 1, а 5 используется для миллисекунд.
Если Вы не специфицировали параметры secondsValue и msValue, используются значения, возвращаемые методами getSeconds и getMilliseconds.
Если Вы специфицировали параметр вне ожидаемого диапазона, setMinutes пытается соответствующим образом обновить информацию даты в объекте Date. Например, если Вы использовали 100 для secondsValue, минуты (minutesValue) будут увеличены на 1 (minutesValue + 1), а 40 будет использовано для секунд.
Если Вы не специфицировали параметр dayValue, используется значение из метода getDate.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setMonth пытается обновить информацию даты в Date -объекте. Например, если Вы использовали 15 для monthValue, год увеличивается на 1 (year + 1), а 3 будет использовано для месяцев/month.
Если Вы не специфицируете параметр msValue, используется значение, возвращаемое методом getMilliseconds.
Если специфицированный Вами параметр находится вне ожидаемого диапазона, setSeconds пытается обновить информацию даты в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты, хранимые в объекте Date, будут увеличены на 1, а 40 будет использовано для секунд.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCDate пытается обновить информацию даты в Date -объекте. Например, если использовано 40 для dayValue, а хранимый в объекте Date месяц - June, день будет изменён на 10, а месяц будет увеличен до July.
Если Вы не специфицировали параметры monthValue и dayValue, используются значения, возвращаемые методами getMonth и getDate.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCFullYear пытается обновить другие параметры и информацию даты в Date -объекте. Например, если Вы специфицировали 15 для monthValue, год увеличивается на 1 (year + 1), а 3 используется для месяца.
Если Вы не специфицировали параметры minutesValue, secondsValue и msValue, используются значения, возвращаемые методами getUTCMinutes, getUTCSeconds и getUTCMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCHours пытается обновить информацию в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты будут увеличены на 1 (min + 1), а 40 будет использовано для секунд.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMilliseconds пытается обновить информацию в Date -объекте. Например, если Вы использовали 1100 для millisecondsValue, секунды, хранимые в объекте Date, будут увеличены на 1, а 100 будет использовано для миллисекунд.
Если Вы не специфицировали параметры secondsValue и msValue, используются значения, возвращаемые методами getUTCSeconds и getUTCMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMinutes пытается обновить информацию в Date -объекте. Например, если Вы используете 100 для secondsValue, минуты (minutesValue) будут увеличены на 1 (minutesValue + 1), а 40 будут использованы для секунд.
Если Вы не специфицировали параметр dayValue, будет использовано значение, возвращаемое методом getUTCDate.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCMonth пытается обновить информацию в Date -объекте. Например, если Вы использовали 15 для monthValue, год будет увеличен на 1 (year + 1), а 3 будет использовано для месяцев.
Если Вы не специфицировали параметр msValue, используется значение, возвращаемое методом getUTCMilliseconds.
Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, setUTCSeconds пытается обновить информацию в Date -объекте. Например, если Вы использовали 100 для secondsValue, минуты, хранимые в Date -объекте, будут увеличены на 1, а 40 будет использовано для секунд.
setYear больше не используется и заменён на метод setFullYear.
Если yearValue это число от 0 до 99 (включительно), то год для dateObjectName устанавливается в 1900 + yearValue. Иначе год для dateObjectName устанавливается в yearValue.
Чтобы учесть годы до и после 2000, Вы должны использовать setFullYear вместо setYear, чтобы год был специфицирован полностью.
toGMTString больше не используется, не рекомендуется к применению и заменён на метод toUTCString.
Точный формат возвращаемого toGMTString значения варьируется в зависимости от платформы.
Вы должны использовать Date.toUTCString вместо toGMTSTring.
Если Вы передаёте дату с использованием toLocaleString, имейте в виду, что разные платформы ассемблируют строки по-разному. Методы, такие как getHours, getMinutes и getSeconds, дают более переносимые результаты.
Метод toLocaleString опирается на ОС при форматировании дат. Он конвертирует дату в строку, используя соглашения по форматированию операционной системы, на которой скрипт запущен. Например, в США месяц идёт перед числом (04/15/98), а в Германии число идёт перед месяцем (15.04.98). Если ОС не решает проблему year-2000 и не использует полный год для лет до 1900 или после 2000, toLocaleString возвращает строку, которая не решает проблему year-2000. toLocaleString ведёт себя аналогично методу toString при конвертации года, который ОС форматирует несоответствующим образом.
Метод toSource возвращает следующие значения:
Для встроенного объекта Date метод toSource возвращает следующую строку, указывающую, что исходный код недоступен: function Date() {Этот метод обычно вызывается JavaScript внутренне, а не явно в коде.
Объект Date переопределяет метод toString объекта Object; он не наследует Object.toString. Для объектов Date метод toString возвращает строковое представление объекта.
JavaScript автоматически вызывает метод toString, когда даты представлена как текстовое значение или когда на дату ссылаются при конкатенации строк.
Значение, возвращаемое методом toUTCString, является читаемой строкой, сформатированной в соответствии с соглашением UTC. Формат return-значения может варьироваться в зависимости от платформы.
UTC принимает разделённые запятыми параметры даты и возвращает количество миллисекунд прошедшее в период от 1 января 1970 года 00:00:00 всемирного времени до времени, специфицированного Вами.
Вы должны специфицировать полный год для year; например, 1998. Если специфицирован год в диапазоне от 0 до 99, метод конвертирует год в год 20 столетия (1900 + year); например, если специфицировано 95, используется 1995 год.
Метод UTC отличается от конструктора Date двумя позициями:
Date.UTC использует всемирное время, а не локальное. Date.UTC возвращает значение времени как число, вместо создания объекта Date.Если специфицированный Вами параметр находится вне пределов ожидаемого диапазона, метод UTC обновляет другие параметры Вашего числа. Например, если Вы используете 15 для month, год будет увеличен на 1 (year + 1), а 3 будет использоваться для месяца.
Поскольку UTC это static-метод объекта Date, Вы всегда используете его так Date.UTC(), а не как метод созданного Вами Date -объекта.
Метод valueOf объекта Date возвращает примитивное значение объекта Date как тип данных number (число), количество миллисекунд, прошедших после полуночи 01 января 1970 года по UTC.
Это метод обычно вызывается в JavaScript внутренне, а не явно в коде.
Документ HTML состоит из тэгов HEAD и BODY. Тэг HEAD содержит информацию о заголовке и базе документа (абсолютном базовом URL, используемом для разрешения относительных URL-гиперссылок данного документа). Тэг BODY содержит тело документа, которое определяется текущим URL. Всё тело документа (все остальные элементы HTML данного документа) находится внутри тэгов BODY.
Вы можете загружать новый документ, устанавливая свойство window.location.
Вы можете очистить панель документа (и удалить текст, элементы формы и т.д., и они не будут больше отображаться) с помощью таких операторов:
document.close();Можно опустить вызов document.open, если Вы пишете текст или HTML, поскольку write выполняет неявное открытие MIME-типа, если поток документа закрывается.
Вы можете обращаться к якорям/anchors, формам/forms и ссылкам/ links документа, используя массивы anchors, forms и links. Эти массивы содержат вхождения для каждого якоря, формы или ссылки документа и являются свойствами объекта document.
Не используйте location как свойство объекта document; используйте вместо него свойство document.URL. Свойство document.location, которое является синонимом свойства document.URL, не рекомендуется применять.
Свойство alinkColor выражается как 16-ричный триплет RGB или как строковой литерал (см. книгу Клиентский JavaScript. Руководство.). Это свойство является отражением в JavaScript атрибута ALINK тэга BODY.
Если Вы выводите цвет как 16-ричный триплет RGB, Вы обязаны использовать формат rrggbb. Например, 16-ричное значение RGB цвета salmon будет red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072".
Вы можете обращаться к объектам Anchor в Вашем коде, используя массив anchors. Этот массив содержит вхождение для каждого тэга A, имеющего атрибут NAME; это вхождения в порядке расположения в исходном коде документа. Например, если документ содержит три именованных якоря со значениями атрибута NAME anchor1, anchor2 и anchor3, Вы можете обратиться к этим якорям так:
document.anchors["anchor1"]или так:
document.anchors[0]Для получения количества якорей в документе используйте свойство length: document.anchors.length. Если документ содержит якоря, именованные в системном порядке натуральными числами, Вы можете использовать массив anchors и его свойство length для проверки имени якоря перед его использованием в операциях типа установки location.hash.
Вы можете обращаться к аплетам через использование массива applets. Этот массив содержит вхождения для каждого объекта Applet (тэг APPLET) в документе; вхождения соответствуют порядку появления аплетов в исходном коде страницы. Например, если документ содержит три аплета со значениями атрибута NAME app1, app2 и app3, Вы можете обращаться к аплетам так:
document.applets["app1"]или так:
document.applets[0]Чтобы получить число аплетов в документе, используйте свойство length: document.applets.length.
Свойство bgColor выражается как 16-ричный RGB-триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). Это свойство является отражением в JavaScript атрибута BGCOLOR тэга BODY. По умолчанию значение этого свойства устанавливается пользователем в диалоговом окне настроек.
Если Вы записываете цвет как 16-ричный RGB-триплет, Вы обязаны использовать формат rrggbb. Например, 16-ричные значения RGB для цвета salmon будут red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072".
Если окно с фрэймами должно отлавливать события на страницах, загружаемых с разных серверов, Вам необходимо использовать window.captureEvents в помеченном скрипте с предшествующим window.enableExternalCapture. Информацию и пример см. в статье window.enableExternalCapture.
captureEvents работает в паре с releaseEvents, routeEvent и handleEvent. О событиях см. дополнительно Клиентский JavaScript. Руководство.
Используйте свойство classes для специфицирования стиля тэгов HTML, имеющих специфический атрибут CLASS. Например, Вы можете специфицировать, что цвет класса GreenBody тэгов P или BLOCKQUOTE будет зелёным. См. в объекте Style описание стилевых свойств, которые Вы можете специфицировать для classes.
Если Вы используете свойство classes внутри тэга STYLE (а не внутри тэга SCRIPT), Вы можете по выбору опустить document в синтаксисе classes. Свойство classes всегда применяется к текущему объекту document.
Метод close закрывает поток, открытый методом document.open. Если поток был открыт для отображения, метод close форсирует отображение содержимого потока. Тэги стиля шрифта, такие как BIG и CENTER, автоматически очищают поток вывода.
Метод close также останавливает "метеорный поток" в иконке Netscape и отображает Document: Done в статусной строке браузера.
Метод contextual предоставляет точный контроль над специфицированием стилей. Он даёт Вам возможность применять стиль к HTML-элементу, который появляется в очень специфическом контексте. Например, Вы можете специфицировать, что цвет текста внутри тэга EM, который находится внутри тэга H1, будет голубым/blue.
Затем Вы можете уточнить выбор, специфицируя несколько контекстов. Например, Вы можете установить цвет любого тэга LI с двумя или более родительскими UL, специфицировав UL для первых двух контекстов.
Кука это небольшой блок информации, сохраняемый web-браузером в файле cookies.txt. Используйте string -методы, такие как substring, charAt, indexOf и lastIndexOf, для определения значения, хранимого в куке. См. в разделах Приложение C, "Куки Netscape" полную спецификацию синтаксиса кук.
Вы можете установить свойство cookie в любое время.
Компонент "expires=" в куки-файле устанавливает срок окончания действия куки, так что она может существовать по окончании текущей сессии браузера. Эта строка даты форматируется так:
Wdy, DD-Mon-YY HH:MM:SS GMTЭтот формат представляет следующие значения:
Wdy - строка с полным названием дня недели. DD - целое число - число месяца. Mon - строка - трёхбуквенная аббревиатура названия месяца. YY - целое число - последние две цифры года. HH, MM и SS это двухсимвольные представления часа, минут и секунд, соответственно.Например, верная дата окончания срока действия куки выглядит так:
expires=Wednesday, 09-Nov-99 23:12:40 GMTФормат даты куки - тот же самый, что и у даты, возвращаемой методом toGMTString, со следующими исключениями:
Между значениями дня, месяца и года добавляются тире. Год в куке это значение из двух цифр.JavaScript 1.1. Свойство domain даёт скриптам возможность совместно использовать свойства на нескольких серверах, когда разрушение данных не включено. Если разрушение отключено, скрипт, запущенный в одном окне, может читать свойства другого окна только тогда, когда оба окна получены от одного Web-сервера. Но на больших Web-сайтах с несколькими серверами может понадобиться совместно использовать свойства несколькими серверами. Например, скрипту на хосте www.royalairways.com может понадобиться использовать свойства совместно со скриптом на хосте search.royalairways.com.
Если скрипты на двух разных серверах изменяют свои свойства domain таким образом, что оба скрипта имеют одно имя домена, оба скрипта могут использовать свойства совместно. Например, скрипт, загруженный с search.royalairways.com может установить своё свойство domain в "royalairways.com". Скрипт с www.royalairways.com, запущенный в другом окне, также может установить своё свойство domain в "royalairways.com". Затем, поскольку оба скрипта имеют домен "royalairways.com", они могут совместно использовать свойства, хотя они и не происходят с одного сервера.
Вы можете изменить domain только с ограничениями. Сначала domain содержит hostname Web-сервера, с которого документ был загружен. Вы можете установить domain только в доменном суффиксе самого домена. Например, скрипт с search.royalairways.com не может установить свойство domain в "search.royalairways". А скрипт с IWantYourMoney.com не может установить свой домен в "royalairways.com".
После изменения свойства domain Вы не можете вернуть его обратно в оригинальное значение. Например, если Вы изменяете domain с "search.royalairways.com" на "royalairways.com", Вы не можете восстановить его обратно в "search.royalairways.com".
Вы можете обратиться к встроенным объектам (созданных тэгом EMBED) в Вашем коде, используя массив embeds. Этот массив содержит вхождение для каждого тэга EMBED в документе в порядке их появления. Например, если документ содержит три внедрённых объекта с атрибутами NAME e1, e2 и e3, Вы можете обратиться к этим объектам так:
document.embeds["e1"]или так:
document.embeds[0]Для получения количества внедрённых объектов документа используйте свойство length: document.embeds.length.
Элементы в массиве embeds могут иметь вызываемые public-функции, если они обращаются к plug-in'у, который использует LiveConnect. См. информацию по LiveConnect в книге Клиентский JavaScript. Руководство.
Используйте элементы массива embeds для взаимодействия с plug-in, который отображает внедрённый объект. Если plug-in не работает с Java, Вы не сможете ничего сделать с его элементом в массиве embeds. Поля и методы элементов массива embeds отличаются от plug-in'а к plug-in'у; см. документацию, поставляемую изготовителем plug-in'а.
Если вы используете тэг EMBED для генерирования вывода из plug-in-приложения, Вы не создаёте объект Plugin.
Свойство fgColor выражается как 16-ричный триплет RGB или как строковой литерал (см. книгу Клиентский JavaScript. Руководство.). Это свойство является отражением в JavaScript атрибута TEXT тэга BODY. По умолчанию значение этого свойства устанавливается пользователем в диалоговом окне настроек. Вы не можете установить это свойство после того как HTML-источник отображён.
Если цвет выражается как 16-ричный RGB-триплет, Вы обязаны использовать формат rrggbb. Например, 16-ричные RGB-значения для цвета salmon будут red=FA, green=80 и blue=72, так что RGB-триплет для salmon будет "FA8072".
Вы можете переопределить значение, установленное в свойстве fgColor, одним из следующих способов:
Установив атрибут COLOR тэга FONT. Использовав метод fontcolor.Вы можете обратиться в Вашем коде к формам, использовав массив forms (Вы можете также использовать имя формы). Это массив содержит вхождение для каждого объекта Form (тэг FORM) документа; эти вхождения расположены в том же порядке, что и в исходном коде. Например, если документ содержит три формы со значениями атрибутов NAME form1, form2 и form3, Вы можете обратиться к объектам массива forms так:
document.forms["form1"]или так:
document.forms[0]Дополнительно объект document имеет отдельное свойство для каждой именованной формы, так что Вы можете обратиться к этим формам таким образом:
document.form1Например, Вы можете обратиться к объекту Text с именем quantity во второй форме: document.forms[1].quantity. Вы можете обратиться к свойству value этого объекта Text: document.forms[1].quantity.value.
Значение каждого элемента в массиве forms это <object nameAttribute>, где nameAttribute это атрибут NAME формы.
Для получения количества форм документа используйте свойство length: document.forms.length.
Используйте свойство ids для специфицирования стиля любого тэга HTML, имеющего специфический атрибут ID. Например, Вы можете специфицировать, что цвет NewTopic ID - зелёный. См. в объекте Style описание стилевых свойств, которые Вы можете специфицировать для ids.
Свойство ids используется, когда Вам нужно предоставить исключение для класса, определённого в свойстве document.classes.
Если Вы используете свойство ids внутри тэга STYLE (вместо тэга SCRIPT), Вы можете по выбору исключить document из синтаксиса ids. Свойство ids всегда применяется к текущему объекту document.
Свойство lastModified происходит от даты шапки HTTP, высылаемой web-сервером. Серверы обычно получают эту дату, проверяя дату изменения файла.
Дата последнего изменения не является необходимой частью шапки/header, и некоторые серверы её не предоставляют. Если сервер не возвращает информацию о дате последнего изменения, JavaScript получает 0, который отображается как January 1, 1970 GMT. Следующий код проверяет дату, возвращаемую свойством lastModified, и выводит значение, соответствующее неизвестной дате.
lastmod = document.lastModified // получить строку с датой последнего измененияВы можете обращаться к слоям Вашего документа, используя массив layers. Этот массив содержит вхождение для каждого объекта Layer (тэг LAYER или ILAYER) документа; эти вхождения идут в порядке расположения в исходном коде. Например, если документ содержит три слоя с атрибутами NAME layer1, layer2 и layer3, Вы можете обратиться к этим объектам в массиве layers так:
document.layers["layer1"]или так:
document.layers[0]При доступе по целочисленному индексу массив элементов идёт в порядке z-order спереди назад, где 0 это самый нижний слой, а более высокие слои индексируются последующими целыми числами. Индекс слоя - не тот же, что его свойство zIndex, так как второе не обязательно перечисляет слои последовательными целыми числами. Смежные слои могут иметь одинаковые значения свойства zIndex.
Вот правильные способы доступа к объектам слоёв:
document.layerNameЭлементы массива layers это JavaScript-объекты, которые не могут быть установлены операцией присвоения, хотя их свойства - могут. Например, оператор
document.layers[0]="music"является неправильным (и игнорируется), так как он пытается изменить массив layers. Однако свойства объектов массива можно читать, а некоторые из них можно записывать. Например, оператор
document.layers["suspect1"].left = 100;является верным. Он устанавливает позицию слоя по горизонтали в 100. В следующем примере цвет фона устанавливается в blue для слоя bluehouse, который вложен в слой houses.
document.layers["houses"].layers["bluehouse"].bgColor="blue";Для получения количества слоёв документа используйте свойство length: document.layers.length.
Свойство linkColor выражается как 16-ричный RGB-триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). Это свойство является отражением в JavaScript атрибута LINK тэга BODY. Значение по умолчанию этого свойства устанавливается пользователем в диалоговом окне установок браузера. Вы не можете установить это свойство после того как исходный код HTML отображён.
При выражении цвета как 16-ричного RGB-триплета Вы обязаны использовать формат rrggbb. Например, 16-ричные значения RGB для цвета salmon будут red=FA, green=80 и blue=72, поэтому RGB-триплет для salmon будет "FA8072".
Вы можете обращаться к объектам Area и Link в Вашем коде через использование массива links. Этот массив содержит вхождение для каждого объекта Area (тэг <AREA HREF="...">) и Link (<A HREF="...">) документа в порядке появления в исходном коде. Он также содержит ссылки, созданные методом link. Например, если в документе есть три ссылки, можно обратиться к ним так:
document.links[0]Для получения общего количества ссылок в документе, используйте свойство length: document.links.length.
Значения для mimeType:
text/html специфицирует документ, содержащий ASCII-текст с форматированием HTML. text/plain специфицирует документ, содержащий обычный ASCII-текст с символами конца строки для разграничения отображаемых строк.image/gif специфицирует документ, кодирующий байты, образующие GIF-шарку и пикселные данные. image/jpeg специфицирует документ, кодирующий байты, образующие JPEG-шапку и пикселные данные. image/x-bitmap специфицирует документ, кодирующий байты, образующие битовую шапку и пикселные данные. plugIn загружает специфицированный plug-in и использует его как цель/назначение для методов write и writeln. Например, "x-world/vrml" загружает VR Scout VRML plug-in с Chaco Communications, а "application/x-director" загружает Macromedia Shockwave plug-in. MIME-типы рlug-in'ов верны только тогда, когда пользователь установил требуемое программное обеспечение для plug-in'а.Метод open открывает поток для сбора вывода методов write или writeln. Если mimeType это text или image, поток открывается для вывода; иначе поток открывается для plug-in'а. Если документ существует в целевом окне, метод open очищает его.
Поток закрывается путём использования метода document.close. Метод close вызывает отображение текста или изображений, которые были посланы для вывода. После использования document.close вызовите document.open ещё раз, если Вам нужно начать другой поток вывода.
В JavaScript 1.1 или позднее document.open или document.open("text/html") очищает текущий документ, если он закончил загрузку. Поэтому этот тип вызова open записывает по умолчанию тэг <BASE HREF=>, так что Вы можете генерировать относительные URL на основе базы документа, генерирующего скрипт.
Ключевое слово "replace" вызывает повторное использование новым документом вхождения в history, использованного предыдущим документом. Если Вы специфицируете "replace" при открытии документа, размер истории/history не увеличивается, даже если Вы записали в окно и закрыли его.
"replace" обычно используется в окне, в котором находится пустой документ или документ с URL "about:blank". После специфицирования "replace" метод write обычно генерирует HTML для окна, замещая вхождение в history для пустого URL. Будьте внимательны при использовании генерируемого HTML в окне с пустым/blank URL. Если Вы не специфицируете "replace", генерируемый HTML имеет своё собственное вхождение в history, и пользователь может, нажав кнопку Back, вернуться в пустой фрэйм.
После выполнения document.open("text/html","replace") history.current для целевого окна будет URL документа, который выполнил document.open.
Когда пользователь переходит к другому документу, щёлкая объект Link в исходном документе, свойство referrer содержит URL исходного документа.
referrer является пустым, если пользователь ввёл URL в окне Location браузера и использовал какой-нибудь иной способ получения текущего URL. referrer является пустым также, если сервер не предоставляет информации о переменной окружения.
releaseEvents работает вместе с captureEvents, routeEvent и handleEvent. О событиях см. дополнительно книгу Клиентский JavaScript. Руководство.