Клиентский JavaScript. Справочник
length выдаёт количество аргументов, реально
arguments. length выдаёт количество аргументов, реально переданных функции. В отличие от него, свойство Function.length указывает, сколько аргументов функция ожидает.
arity является внешним относительно функции
arity является внешним относительно функции и указывает, какое количество аргументов функция ожидает. В отличие от него, arguments.length предоставляет количество аргументов, реально переданных функции.
Вы можете присвоить разные объекты
Вы можете присвоить разные объекты this при вызове существующей функции. this ссылается на текущий (вызывающий) объект.
С помощью call Вы можете записать метод однократно и затем наследовать его в другом объекте без необходимости записывать его ещё раз для нового объекта.
length является внешним относительно функции
length является внешним относительно функции и указывает, сколько аргументов функция ожидает. В противоположность ему, arguments.length является локальным относительно функции и представляет количество аргументов, реально переданных функции.
в существующий класс новые свойства
Вы можете добавлять в существующий класс новые свойства или методы, добавляя их в прототип, ассоциированный с конструктором данного класса. Синтаксис добавления нового свойства или метода таков:
fun.prototype.name = value где
| fun | Имя конструктора объекта, который вы хотите изменить. |
| name | Имя создаваемого свойства или метода. |
| value | Значение, присвоенное первоначально новому свойству или методу. |
var array1 = new Array();
var array2 = new Array(3);
Array.prototype.description=null;
array1.description="Contains some stuff"
array2.description="Contains other stuff" После установки свойства в прототипе все объекты, созданные с помощью Array, будут иметь это свойство:
anotherArray=new Array()
anotherArray.description="Currently empty"
Для встроенного объекта Function метод
Метод toSource возвращает следующие значения:
Для встроенного объекта Function метод toSource возвращает следующие строки, указывающие на недоступность исходного кода: function Function() {
[native code]
} Для специальных функций метод toSource возвращает исходный код JavaScript, который определяет объект как строку.Этот метод обычно вызывается JavaScript внутренне, а не явно в коде. Вы можете вызывать toSource при отладке для проверки содержимого объекта.
Объект Function переопределяет метод toString
Объект Function переопределяет метод toString объекта Object; он не наследует Object.toString. Для объектов Function метод toString возвращает строку, представляющую объект.
JavaScript вызывает метод toString автоматически, если Function представлен как текстовое значение или если на Function имеется ссылка при конкатенации строк.
Для объектов Function встроенный метод toString декомпилирует функцию обратно в исходный код JavaScript, который определяет функцию. Эта строка содержит ключевое слово function, список аргументов, фигурные скобки и тело функции.
Например, имеется следующий код, где определяется тип объектов Dog и создаётся theDog, объект типа Dog:
function Dog(name,breed,color,sex) {
this.name=name
this.breed=breed
this.color=color
this.sex=sex
}theDog = new Dog("Gabby","Lab","chocolate","girl") Когда Dog используется в строковом контексте, JavaScript автоматически вызывает функцию toString, которая возвращает следующие строки:
function Dog(name, breed, color, sex) { this.name = name; this.breed = breed; this.color = color; this.sex = sex; }
Для встроенного объекта Function метод
Метод valueOf возвращает следующие значения:
Для встроенного объекта Function метод valueOf возвращает следующую строку, указывающую, что исходный код недоступен:function Function() {
[native code]
} Для специальных функций метод toSource возвращает исходный код JavaScript, который определяет объект, в виде строки. Этот метод эквивалентен методу toString функции. Этот метод обычно вызывается JavaScript внутренне, а не явно в коде.
Объект Hidden является элементом формы
Объект Hidden является элементом формы и обязан быть определён в тэге FORM.
Объект Hidden не может быть виден конечному пользователю и не может им изменяться, но Вы можете программно изменить значение этого объекта, изменяя его свойство value. Вы можете использовать объекты Hidden для взаимодействия клиент/сервер.
Каждый элемент формы имеет свойство
Каждый элемент формы имеет свойство form, которое является ссылкой на родительскую форму элемента. Это свойство в основном используется в обработчиках событий, где Вам может понадобиться обратиться к другому элементу на этой же форме.
Для изменения текущего URL окна
Для изменения текущего URL окна без генерации вхождения в history Вы можете использовать метод Location.replace. При этом текущая страница замещается другой без генерации вхождения в history. См. Location.replace.
Вы можете обратиться ко вхождениям в history через использование массива window.history. Этот массив содержит вхождение для каждого вхождения в history в порядке исходного кода. Каждое вхождение массива является строкой, содержащей URL. Например, если список history содержит три именованных вхождения, эти вхождения отражаются как history[0], history[1] и history[2].
Если Вы получаете доступ к массиву history без специфицирования элемента массива, браузер возвращает строку HTML, которая выводит таблицу URLs, каждый из которых является ссылкой.
Этот метод выполняет такую же
Этот метод выполняет такую же акцию, что и пользователь, нажимая кнопку Back в браузере. Метод back это то же, что и history.go(-1).
Этот метод выполняет такое же
Этот метод выполняет такое же действие, что и пользователь, нажимающий кнопку Forward в браузере. Метод forward это то же, что и history.go(1).
к точке списка history, определённой
Метод go переходит к точке списка history, определённой специфицированным параметром.
Если аргумент delta равен 0, браузер перезагружает текущую страницу. Если целое число больше 0, метод go загружает URL, находящийся на специфицированное число вхождений впереди в списке history; иначе (если меньше 0) он загружает URL, находящийся на специфицированное число вхождений назад в списке history.
Аргумент location это строка. Используйте location для загрузки ближайшего вхождения из history, чей URL содержит location в качестве подстроки. Совпадение URL с параметром location делается с учётом регистра. Каждый раздел URL содержит свою информацию. См. в Location описание компонентов URL.
Метод go создаёт новое вхождение в списке history. Для загрузки URL без создания вхождения в списке history используйте Location.replace.
в документе устанавливаются при отображении
Позиция и размер изображения в документе устанавливаются при отображении документа web-браузером и не могут быть изменены с помощью JavaScript (свойства width и height являются для данного объекта read-only). Вы можете изменить выводимое изображение, установив свойства src и lowsrc. (См. описание Image.src и Image.lowsrc.)
Вы можете использовать JavaScript для создания анимации из объекта Image, выполняя повторяющуюся установку свойства src, как показано далее в Примере 4. Анимация JavaScript работает медленнее, чем GIF-анимация, поскольку GIF-анимация это один файл; при анимации JavaScript каждый фрэйм является отдельным файлом, и каждый файл обязан быть загружен из сети (установление связи с хостом, перенос данных...).
В основном объект Image, создаваемый конструктором Image, предназначен для загрузки изображения по сети (и его декодирования) до того момента, когда оно понадобится для отображения. Затем, если Вам нужно вывести изображение в существующей ячейке изображения, Вы устанавливаете в свойство src выводимого изображения то значение, которое используется для полученного ранее изображения:
myImage = new Image()
myImage.src = "seaotter.gif"
...
document.images[0].src = myImage.src Результирующее изображение будет получено из кэша, а не загружено по сети, что значительно сэкономит время, необходимое для загрузки и декодирования изображения. Можно использовать эту технику для создания сложных анимаций или выводить одно из нескольких изображений на основе ввода данных в форму.
Свойство border отражает атрибут BORDER
Свойство border отражает атрибут BORDER тэга IMG. Для изображений, созданных конструктором Image, значение свойства border равно 0.
Свойство height отражает атрибут HEIGHT
Свойство height отражает атрибут HEIGHT тэга IMG. Для изображений, созданных конструктором Image, значение свойства height является реальной, а не отображаемой, высотой изображения.
Свойство hspace отражает атрибут HSPACE
Свойство hspace отражает атрибут HSPACE тэга IMG. Для изображений, созданных конструктором Image, значение свойства hspace равно 0.
Свойство lowsrc первоначально отражает атрибут
Свойство lowsrc первоначально отражает атрибут LOWSRC тэга IMG. Браузер загружает меньшее изображение, специфицированное свойством lowsrc, а затем замещает его изображением большего размера, специфицированным в свойстве src. Вы можете изменить свойство lowsrc в любое время.
Представляет значение атрибута NAME. Для
Представляет значение атрибута NAME. Для изображений, созданных конструктором Image, значение свойства name равно null.
Свойство src первоначально отражает атрибут
Свойство src первоначально отражает атрибут SRC тэга IMG. Установка свойства src начинает загрузку нового URL в область изображения (и прерывает передачу любых данных изображения, которые загружались в ту же самую область). Следовательно, если Вы планируете изменить свойство lowsrc, Вы должны сделать это до установки свойства src.
Если URL в свойстве src ссылается на изображение, которое имеет размер, отличный от размера ячейки, в которую оно загружается, изображение-источник масштабируется.
Если Вы изменяете свойство src выведенного изображения, новое изображение, которое Вы специфицируете, выводится в области, определённой для оригинального изображения. Например, объект Image первоначально выводит файл beluga.gif:
<IMG NAME="myImage" SRC="beluga.gif" ALIGN="left"> Если Вы устанавливаете myImage.src='seaotter.gif', изображение seaotter.gif масштабируется для вмещения в то же пространство, которое первоначально было использовано для beluga.gif, даже если seaotter.gif не имеет те же размеры, что и beluga.gif.
Вы можете изменить свойство src в любое время.
Свойство vspace отражает атрибут VSPACE
Свойство vspace отражает атрибут VSPACE тэга IMG. Для изображений. созданных конструктором Image, значение свойства vspace равно 0.
Свойство width отражает атрибут WIDTH
Свойство width отражает атрибут WIDTH тэга IMG. Для изображений, созданных конструктором Image, значение свойства width является реальной фактической, а не отображаемой, шириной изображения.
в JavaScript. JavaArray является оболочкой
Объект JavaArray является экземпляром Java-массива, который создаётся в или передаётся в JavaScript. JavaArray является оболочкой для экземпляра; все ссылки на этот экземпляр массива делаются через JavaArray.
Вы обязаны специфицировать объект класса, такой как объект, возвращаемый java.lang.Object.forName для параметра componentType экземпляра newInstance, если Вы используете этот метод для создания массива. Вы не можете использовать объект JavaClass для параметра componentType.
Используйте индексы с базой 0 для доступа к элементам объекта JavaArray так же, как Вы делаете при доступе к элементам массива в языке Java. Например:
var javaString = new java.lang.String("Hello world!");
var byteArray = javaString.getBytes();
byteArray[0] // возвращает 72
byteArray[1] // возвращает 101 Любые Java-данные, перенесённые в JavaScript, конвертируются в типы данных JavaScript. Если JavaArray передаётся обратно в Java, оболочка с массива снимается, и он может использоваться кодом Java. См. в книге Клиентский JavaScript. Руководство. информацию о конвертации типов данных.
length является свойством только для
В отличие от Array.length, JavaArray. length является свойством только для чтения. Вы не можете изменить значение свойства JavaArray.length, поскольку массивы Java всегда имеют фиксированное количество элементов.
Метод toString наследуется из объекта
Метод toString наследуется из объекта Object и возвращает следующее значение:
[object JavaArray]
Объект JavaClass является ссылкой на
Объект JavaClass является ссылкой на один из классов Java-пакета, такого как netscape.javascript.JSObject. Объект JavaPackage является ссылкой на Java-пакет, такой как netscape.javascript. В JavaScript иерархия JavaPackage и JavaClass отражает иерархию пакетов и классов Java.
Вы обязаны создать оболочку вокруг экземпляра java.lang.Class, прежде чем передать его в качестве параметра Java-методу -- JavaClass-объекты не конвертируются автоматически в экземпляры java.lang.Class.
в JavaScript. JavaObject является оболочкой
Объект JavaObject является экземпляром Java-класса, который создаётся в или передаётся в JavaScript. JavaObject является оболочкой экземпляра; все ссылки на экземпляр класса делаются через JavaObject.
Любые данные Java, перенесённые в JavaScript, конвертируются в типы данных JavaScript. Если JavaObject передаётся обратно в Java, оболочка с него снимается, и он может использоваться в коде Java. См. в книге Клиентский JavaScript. Руководство. информацию о конвертации типов данных.
В Java пакет является коллекцией
В Java пакет является коллекцией Java-классов или других Java-пакетов. Например, пакет netscape содержит пакет netscape.javascript; пакет netscape.javascript содержит классы JSObject и JSException.
В JavaScript объект JavaPackage является ссылкой на Java-пакет. Например, ссылкой на netscape является JavaPackage.
netscape.javascript является одновременно объектом JavaPackage и свойством из netscape JavaPackage.
Объект JavaClass является ссылкой на один из классов пакета, такой как netscape.javascript.JSObject. Иерархия JavaPackage и JavaClass отражает иерархию пакетов и классов Java.
Хотя пакеты и классы, содержащиеся в JavaPackage, являются его свойствами, Вы не можете использовать оператор for...in для перечисления их, как это можно сделать в других объектах.
Каждый слой имеет свойство background,
Каждый слой имеет свойство background, значением которого является объект image, атрибут src которого это URL, указывающий на изображение, используемое для размножения и заполнения фона. Значение null будет тогда, когда слой не имеет фона. Например:
layer.background.src = "fishbg.gif";
триплет или как строковой литерал
Свойство bgColor выражается как 16-ричный RGB- триплет или как строковой литерал (см. книгу Клиентский JavaScript. Руководство). Это свойство является отражением в JavaScript атрибута BGCOLOR тэга BODY.
Вы можете установить свойство bgColor в любой момент.
Если Вы выражаете цвет как 16-ричный RGB-триплет, Вы обязаны использовать формат rrggbb. Например, 16-ричные значения RGB для цвета salmon - red=FA, green=80 и blue=72, и RGB-триплет для salmon будет, соответственно, "FA8072".
с фрэймами должно захватывать события
Если окно с фрэймами должно захватывать события на страницах, загруженных с других серверов, Вам нужно будет использовать captureEvents в помеченном скрипте с предшествующим enableExternalCapture. Дополнительную информацию и примеры см. в разделе о enableExternalCapture.
captureEvents работает вместе с releaseEvents, routeEvent и handleEvent. Информацию по обработке событий см. в книге Клиентский JavaScript. Руководство.
Каждый объект layer содержит свой
Каждый объект layer содержит свой собственный объект document. Этот объект может использоваться для доступа к изображениям, аплетам, гиперссылкам, внедрённым объектам, якорям и слоям, которые находятся в слое. Методы объекта document также могут вызываться для изменения содержимого слоя.
и routeEvent. Информацию по обработке
handleEvent работает вместе с captureEvents, releaseEvents и routeEvent. Информацию по обработке событий см в книге Клиентский JavaScript. Руководство.
Изменяет позицию слоя на специфицированные,
Изменяет позицию слоя на специфицированные, в пикселах, координаты в пределах содержащего слоя. Для ILayers перемещает слой относительно естественной inflow-позиции слоя.
Этот метод эквивалентен установке свойств
Этот метод эквивалентен установке свойств pageX и pageY объекта layer.
Если первоначальной целью события является
Если первоначальной целью события является окно, это окно получает событие даже в том случае, если оно (окно) имеет установку - освобождать события данного типа. releaseEvents работает вместе с captureEvents, routeEvent и handleEvent. Дополнительно см. книгу Клиентский JavaScript. Руководство.
Он не распределяет HTML, содержащийся
Он не распределяет HTML, содержащийся в слое. Наоборот, содержимое слоя может быть обрезано по новым границам слоя. Этот метод даёт тот же эффект, что и добавление width и height в clip.width и clip.height.
Он не распределяет HTML, содержащийся
Он не распределяет HTML, содержащийся в слое. Наоборот, содержимое слоя может быть обрезано по новым границам слоя.
Этот метод даёт тот же
Этот метод даёт тот же эффект, что и установка clip.width и clip.height.
документ или слой) также захватывает
Если субобъект ( документ или слой) также захватывает событие, это событие передаётся этому объекту. Иначе оно пересылается цели-оригиналу.
routeEvent работает вместе с captureEvents, releaseEvents и handleEvent. Дополнительно см. книгу Клиентский JavaScript. Руководство.
наследовать видимость от родительского
Значение show - показать слой; hide - скрыть слой; inherit - наследовать видимость от родительского слоя.
в стэке под данным слоем.
Слои-родственники с более низкими z-индексами помещаются в стэке под данным слоем. Значение zIndex обязано быть 0 или положительным целым числом.
и имеет те же свойства,
Каждый Link является location-объектом и имеет те же свойства, что и location-объект.
Если Link-объект является также Anchor-объектом, он имеет вхождения и в массиве anchors, и в массиве links.
Если пользователь щёлкает Link-объект и переходит к документу назначения (специфицируемому атрибутом HREF="locationOrURL"), свойство referrer документа назначения содержит URL исходного документа.
Вы можете использовать Link-объект для выполнения функции JavaScript, а не для перехода по ссылке, специфицировав URL-протокол javascript: в атрибуте HREF гиперссылки. Вам это может понадобиться, если ссылка содержит объект Image и Вы хотите выполнить код JavaScript при щелчке по изображению. Либо Вам может понадобиться использовать ссылку вместо кнопки для выполнения кода JavaScript.
Например, если пользователь щёлкает по следующим ссылкам, выполняются функции slower и faster:
<A HREF="javascript:slower()">Slower</A>
<A HREF="javascript:faster()">Faster</A> Вы можете использовать объект Link, чтобы не выполнять никаких действий, специфицировав URL-протокол javascript:void(0) в атрибуте HREF гиперссылки. Вам это может понадобиться, если ссылка окружает объект Image и Вы хотите использовать обработчики события ссылки для изображения. Если пользователь щёлкает по следующим ссылкам, ничего не происходит:
<A HREF="javascript:void(0)">Click here to do nothing</A> <A HREF="javascript:void(0)">
<IMG SRC="images\globe.gif" ALIGN="top" HEIGHT="50" WIDTH="50">
</A>
Свойство hash специфицирует часть URL.
Свойство hash специфицирует часть URL. Это свойство применяется только к HTTP URL.
Будьте внимательны при использовании этого свойства. Предположим, document.links[0] содержит:
http://royalairways.com/fish.htm#angel Тогда document.links[0].hash возвратит #angel. Предположим, у Вас имеется такой код:
hash = document.links[0].hash;
document.links[0].hash = hash; Теперь document.links[0].hash возвращает ##angel.
Это поведение может быть изменено в последующих версиях.
Вы можете установить свойство hash в любой момент, хотя безопаснее делать это до изменения расположения. Если хэш, который Вы специфицируете, не может быть найден в текущем месте, Вы получите ошибку.
Установка свойства hash выполняет переход к именованному якорю без перезагрузки документа. Это отличается от способа загрузки документа при установке свойств link.
См. в документе RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о хэше.
Свойство host специфицирует часть URL.
Свойство host специфицирует часть URL. Свойство host является подстрокой свойства hostname. Свойство hostname образуется путём конкатенации свойств host и port, разделённых двоеточием. Если свойство port имеет значение null, свойство host имеет то же значение, что и свойство hostname.
Вы можете установить свойство host в любой момент, хотя безопаснее установить свойство href для изменения местоположения. Если специфицированный Вами хост не может быть найден в текущем месте, Вы получите ошибку.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о hostname и port.
Свойство hostname специфицирует часть URL.
Свойство hostname специфицирует часть URL. Свойство hostname образуется путём конкатенации свойств host и port, разделённых двоеточием. Если свойство port имеет значение 80 (это значение по умолчанию), свойство host имеет то же значение, что и свойство hostname.
Вы можете установить свойство hostname в любой момент, хотя безопаснее установить свойство href для изменения местоположения. Если специфицированное Вами имя хоста не может быть найдено в текущем месте, Вы получите ошибку.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о hostname.
Свойство href специфицирует весь URL
Свойство href специфицирует весь URL целиком. Другие свойства объекта link являются подстроками свойства href.
Вы можете установить свойство href в любой момент.
См. в RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о URL.
Свойство pathname специфицирует часть URL.
Свойство pathname специфицирует часть URL. Оно даёт детальную информацию о том, как может быть достигнут специфицированный ресурс.
Вы можете установить свойство pathname в любой момент, хотя безопаснее установить свойство href для изменения местоположения. Если специфицированный Вами pathname не может быть найден в текущем месте, Вы получите ошибку.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о pathname.
Свойство port специфицирует часть URL.
Свойство port специфицирует часть URL. Свойство port является подстрокой свойства hostname. Свойство hostname образуется путём конкатенации свойств host и port, разделённых двоеточием. Если свойство port имеет значение 80 (это значение по умолчанию), свойство host имеет то же значение, что и свойство hostname.
Вы можете установить свойство port в любой момент, хотя безопаснее установить свойство href для изменения местоположения. Если специфицированный Вами port не может быть найден в текущем месте, Вы получите ошибку. Если свойство port не специфицировано, по умолчанию предполагается номер порта 80.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о port.
Свойство protocol специфицирует часть URL.
Свойство protocol специфицирует часть URL. Оно указывает метод доступа к URL. Например, значение "http:" специфицирует HyperText Transfer Protocol, а значение "javascript:" специфицирует код JavaScript.
Вы можете установить свойство protocol в любой момент, хотя безопаснее установить свойство href для изменения местоположения. Если специфицированный Вами не может быть найден в текущем месте, Вы получите ошибку.
Свойство protocol представляет схему именования URL. См. в Разделе 2.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о protocol.
Свойство search является частью URL.
Свойство search является частью URL. Это свойство применяется только к http URLs.
Свойство search содержит пары переменная/значение; каждая пара отделена амперсандом. Например, две пары в строке поиска могут выглядеть так:
?x=7&y=5 Вы можете установить свойство search в любой момент, хотя безопаснее установить свойство href для изменения местоположения. Если специфицированное Вами search не может быть найдено в текущем месте, Вы получите ошибку.
См. в Разделе 3.3 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о search.
Свойство target первоначально отражает значение
Свойство target первоначально отражает значение атрибута TARGET тэгов A или AREA; однако установка target переопределяет этот атрибут.
Вы можете установить target с использованием строки, если строка представляет имя окна. Свойству target не может быть присвоено значение переменной или выражения JavaScript.
Вы можете установить свойство target в любой момент.
Объект location представляет полный URL,
Объект location представляет полный URL, ассоциированный с данным объектом window. Каждое свойство объекта location представляет разные части URL.
В целом URL имеет форму:
protocol//host:port/pathname#hash?search Например:
http://home.netscape.com/assist/extensions.html#topic1?x=7&y=2 Эти части имеют следующее предназначение:
protocol представляет начало URL до первого двоеточия включительно. host это имя хоста и домена или IP-адрес сетевого хоста. port это порт соединения, используемый сервером. pathname это часть URL-путь URL. hash это фрагмент имени якоря в URL, включая символ хэша (#). Это свойство применяется только к HTTP URLs.search это информация запроса, присоединённая к URL, включая знак вопроса (?). Это свойство применяется только к HTTP URLs. Строка поиска содержит пары переменная/значение; каждая пара отделена амперсандом (&). Объект Location имеет свойства для всех частей URL. См. конкретные свойства. Объект Location имеет ещё два свойства:
href - полный URL. hostname - конкатенация свойств host:port. Если Вы присваиваете строку свойству location объекта, JavaScript создаёт объект location и присваивает эту строку его свойству href. Например, следующие два оператора эквивалентны и устанавливают URL для текущего окна - домашнюю страницу Netscape:
window.location.href="http://home.netscape.com/"
window.location="http://home.netscape.com/" Объект location содержится в объекте window и находится в его области видимости/scope. Если Вы обращаетесь к объекту location без специфицирования window, объект location представляет текущее окно. Если Вы обращаетесь к объекту location и специфицируете имя окна, как, например, windowReference.location, объект location представляет местоположение в специфицированном окне.
В обработчиках событий Вы обязаны специфицировать window.location, а не просто location. Из-за ограничений области видимости static-объектов JavaScript, вызов location без специфицирования имени объекта эквивалентно document.location, что является синонимом для document.URL.
Location не является свойством объекта document; его эквивалентом является свойство document.URL. Свойство document.location, являющееся синонимом для document.URL, применять не рекомендуется.
Как документы загружаются при установленном location. Если Вы установили объект location или любое из его свойств, за исключением hash, то, как загружается новый документ, зависит от версии используемого браузера:
В JavaScript 1.0 установка location выполняет условную операцию ("If-modified-since") HTTP GET, которая не возвращает с сервера, если только документ не был модифицирован с момента загрузки последней версии. В JavaScript 1.1 и позднее эффект от установки location зависит от установок пользователя для сравнения документа с оригиналом по сети. Опция интерфейса пользователя для установки этого свойства зависит от версии браузера. Пользователь определяет, проверять ли документ в кэше браузера каждый раз при доступе к нему, один раз в сессию или никогда. Документ перезагружается из кэша, если пользователь установил опции "никогда" или "один раз в сессию"; документ перезагружается с сервера только в том случае, если пользователь установил опцию "каждый раз при доступе". Синтаксис обычных типов URL. Если Вы специфицируете URL, можно использовать стандартные форматы URL и операторы JavaScript. В таблице показан синтаксис для специфицирования наиболее распространённых типов URL.
Таблица 1.1 Синтаксис URL.
| JavaScript-код | javascript: | javascript:history.go(-1) |
| Программа просмотра исходного кода в Navigator'е | view-source: |
view-source:wysiwyg://0/file:/c|/temp/genhtml.html |
| Navigator info | about: | about:cache |
| World Wide Web | http: |
http://home.netscape.com/ |
| File | file:/ |
file:///javascript/methods.html |
| FTP | ftp: |
ftp://ftp.mine.com/home/mine |
| MailTo | mailto: | mailto:info@netscape.com |
| Usenet | news: |
news://news.scruznet.com/comp.lang.javascript |
| Gopher | gopher: | gopher.myhost.com |
Протокол javascript: вычисляет выражение, идущее после двоеточия (:), если оно имеется, и загружает страницу, содержащую строковое значение выражения, если только оно не undefined. Если выражение вычисляется в undefined (вызовом void-функции, например, javascript:void(0)), новая страница не загружается. Обратите внимание, что загрузка новой страницы поверх Вашей страницы со скриптом очищает значения переменных страницы, функции и т.п. Протокол view-source: выводит код HTML, который был сгенерирован методами JavaScript-методами document.write и document.writeln. О печати и сохранении сгенерированного HTML см. document.write. Протокол about: предоставляет информацию о Navigator'е. Например:
about: этот то же, что и выбор меню About Communicator из Help. about:cache отображает статистику кэширования. about:plugins выводит информацию о plug-ins, сконфигурированных Вами. Это то же самое, что выбор меню About Plug-ins из Help.
Свойство hash специфицирует часть URL.
Свойство hash специфицирует часть URL. Это свойство применяется только к HTTP URL.
Вы можете установить свойство hash в любое время, хотя надёжнее установить свойство href для изменения местоположения. Если установленное Вами свойство hash не может быть найдено в текущем месте, Вы получите ошибку.
Установка свойства hash даёт переход к именованному якорю без перезагрузки документа. Это отличается от загрузки документа при установке других location-свойств (см. "Как загружаются документы при установке location").
См. в документе RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о hash.
Свойство host специфицирует часть URL.
Свойство host специфицирует часть URL. Свойство host является подстрокой свойства hostname. Свойство hostname получается путём конкатенации свойств host и port, разделённых двоеточием. Если значение свойства port равно null, свойство host будет тем же самым, что и свойство hostname.
Вы можете установить свойство host в любое время, хотя надёжнее установить свойство href для изменения местоположения. Если host не может быть найдено в текущем месте, Вы получите ошибку.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о hostname и port.
Свойство hostname специфицирует часть URL.
Свойство hostname специфицирует часть URL. Свойство hostname получается путём конкатенации свойств host и port, разделённых двоеточием. Если свойство port имеет значение 80 (это значение по умолчанию), свойство host будет таким же, что и свойство hostname.
Вы можете установить свойство hostname в любое время, хотя надёжнее установить свойство href для изменения местоположения. Если специфицированное Вами свойство hostname не может быть найдено в текущем месте, Вы получите ошибку.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о hostname.
Свойство href специфицирует полный URL.
Свойство href специфицирует полный URL. Другие свойства объекта location являются подстроками свойства href. Если Вам необходимо изменить URL, ассоциированный с окном, Вы должны изменить свойство href; это корректно обновит все другие свойства.
Вы можете установить свойство href в любое время.
Отсутствие свойства при указании объекта location равносильно специфицированию location.href. Например, следующие два оператора эквивалентны и устанавливают URL текущего окна - домашнюю страницу Netscape:
window.location.href="http://home.netscape.com/"
window.location="http://home.netscape.com/" См. в документе RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о URL.
Свойство pathname специфицирует часть URL.
Свойство pathname специфицирует часть URL. Свойство pathname указывает детали получения доступа к специфицированному ресурсу.
Вы можете установить свойство pathname в любое время, хотя надёжнее установить свойство href для изменения местоположения. Если специфицированное Вами свойство pathname не может быть найдено в текущем месте, Вы получите ошибку.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о pathname.
Свойство port специфицирует часть URL.
Свойство port специфицирует часть URL. Свойство port является подстрокой свойства hostname. Свойство hostname получается путём конкатенации свойств host и port, разделённых двоеточием.
Вы можете установить свойство port в любое время, хотя надёжнее установить свойство href для изменения местоположения. Если специфицированное Вами свойство port не может быть найдено в текущем месте, Вы получите ошибку. Если свойство port не специфицировано, он имеет значение по умолчанию 80.
См. в Разделе 3.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о port.
Свойство protocol специфицирует часть URL.
Свойство protocol специфицирует часть URL. Свойство protocol указывает метод доступа URL. Например, значение "http:" специфицирует протокол HyperText Transfer Protocol, а значение "javascript:" специфицирует код JavaScript.
Вы можете установить свойство protocol в любое время, хотя надёжнее установить свойство href для изменения местоположения. Если специфицированное Вами свойство protocol не может быть найдено в текущем месте, Вы получите ошибку.
Свойство protocol представляет имя схемы URL. См. в Разделе 2.1 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о protocol.
Этот метод использует ту же
Этот метод использует ту же политику, что и кнопка Reload браузера. Интерфейс пользователя для установки значения по умолчанию этой политики варьируется для различных версий браузеров.
По умолчанию метод reload не форсирует транзакцию сервера. Однако, если пользователь установил проверку версии документа при каждом доступе к нему, этот метод выполняет "условный GET-запрос" с использованием HTTP header/шапки If-modified-since для получения с сервера запрашиваемого документа только в том случае, если время last-modified новее, чем время, хранимое в кэше клиента. Другими словами, reload перезагружает документ из кэша только в том случае, если не специфицирована проверка каждый раз и документ не изменился на сервере с момента его последней загрузки и сохранения в кэше.
Метод replace загружает специфицированный URL
Метод replace загружает специфицированный URL поверх текущего вхождения в списке history. После вызова метода replace пользователь не может перейти к предыдущему URL, щёлкнув кнопку Back браузера.
Если Ваша программа работает с JavaScript 1.0, Вы можете поместить следующие строки в тэг SCRIPT перед Вашей программой. Это эмулирует replace, который был введён в JavaScript 1.1:
if (location.replace == null)
location.replace = location.assign Метод replace не создаёт новое вхождение в списке history. Для создания нового вхождения в списке history при загрузке URL используйте метод History.go.
Свойство search специфицирует часть URL.
Свойство search специфицирует часть URL. Это свойство применяется только к HTTP URLs.
Свойство search содержит пары переменная/значение; каждая пара отделяется амперсандом (&). Например, две пары в строке search могут выглядеть так:
?x=7&y=5 Вы можете установить свойство search в любое время, хотя надёжнее установить свойство href для изменения местоположения. Если установленное Вами свойство search не может быть найдено в текущем месте, Вы получите ошибку.
См. в Разделе 3.3 документа RFC 1738 (http://www.cis.ohio-state.edu/htbin/rfc/rfc1738.html) полную информацию о search.
Все свойства объекта Math являются
Все свойства объекта Math являются static/статическими. Вы обращаетесь к константе PI так: Math.PI, и можете вызвать функцию вычисления синуса так: Math.sin(x), где x это аргумент метода. Константы определяются с полной точностью реальных чисел JavaScript.
Часто бывает удобно использовать оператор with при работе с несколькими константами и методами объекта Math, так, чтобы не вводить постоянно "Math". Например:
with (Math) {
a = PI * r*r
y = r*sin(theta)
x = r*cos(theta)
}
метод объекта Math, Вы всегда
Поскольку abs это static- метод объекта Math, Вы всегда записываете его Math.abs(), а не как метод Math-объекта, созданного Вами.
Метод acos возвращает числовое значение
Метод acos возвращает числовое значение в диапазоне от 0 до pi радиан. Если значение number находится вне пределов этого диапазона, метод возвращает NaN.
Поскольку acos это static-метод объекта Math, он всегда записывается Math.acos(), а не как метод Math-объекта, созданного Вами.
Метод asin возвращает числовое значение
Метод asin возвращает числовое значение в диапазоне от -pi/2 до pi/2 радиан. Если значение number находится вне этого диапазона, метод возвращает NaN.
Поскольку asin это static-метод объекта Math, он всегда записывается Math.asin(), а не как метод Math-объекта, созданного Вами.
Метод atan возвращает числовое значение
Метод atan возвращает числовое значение в диапазоне от -pi/2 до pi/2 радиан.
Поскольку atan это static-метод объекта Math, он всегда записывается Math.atan(), а не как метод Math-объекта, созданного Вами.
Метод atan2 возвращает числовое значение
Метод atan2 возвращает числовое значение в диапазоне от -pi до pi, представляющее угол тета точки (x,y). Это угол в направлении против часовой стрелки, в радианах, между положительной осью X и точкой (x,y). Заметьте, что аргументы этой функции передают сначала y-координату, а затем уже x-координату.
В atan2 по отдельности передаются аргументы x и y и частное от деления этих аргументов.
Поскольку atan2 это static-метод объекта Math, он всегда записывается Math.atan2(), а не как метод Math-объекта, созданного Вами.
метод объекта Math, он всегда
Поскольку ceil это static- метод объекта Math, он всегда записывается Math.ceil(), а не как метод Math-объекта, созданного Вами.
Метод cos возвращает числовое значение
Метод cos возвращает числовое значение в диапазоне от -1 до 1, которое представляет косинус угла.
Поскольку cos это static-метод объекта Math, он всегда записывается Math.cos(), а не как метод Math-объекта, созданного Вами.
свойство объекта Math, оно всегда
Поскольку E это static- свойство объекта Math, оно всегда записывается Math.E, а не как свойство Math-объекта, созданного Вами.
метод объекта Math, он всегда
Поскольку exp это static- метод объекта Math, он всегда записывается Math.exp(), а не как метод Math-объекта, созданного Вами.
метод объекта Math, он всегда
Поскольку floor это static- метод объекта Math, он всегда записывается Math.floor(), а не как метод Math-объекта, созданного Вами.
свойство объекта Math, оно всегда
Поскольку LN10 это static- свойство объекта Math, оно всегда записывается Math.LN10, а не как свойство Math-объекта, созданного Вами.
свойство объекта Math, он всегда
Поскольку LN2 это static- свойство объекта Math, он всегда записывается Math.LN2, а не как свойство Math-объекта, созданного Вами.
метод объекта Math, он всегда
Если значение number - отрицательное, return-значение всегда будет NaN.
Поскольку log это static- метод объекта Math, он всегда записывается Math.log(), а не как метод Math-объекта, созданного Вами.
свойство объекта Math, оно всегда
Поскольку LOG10E это static- свойство объекта Math, оно всегда записывается Math.LOG10E, а не как свойство Math-объекта, созданного Вами.
свойство объекта Math, оно всегда
Поскольку LOG2E это static- свойство объекта Math, оно всегда записывается Math.LOG2E, а не как свойство Math-объекта, созданного Вами.
метод объекта Math, он всегда
Поскольку max это static- метод объекта Math, он всегда записывается Math.max(), а не как метод Math-объекта, созданного Вами.
метод объекта Math, он всегда
Поскольку min это static- метод объекта Math, он всегда записывается Math.min(), а не как метод Math-объекта, созданного Вами.
свойство объекта Math, оно всегда
Поскольку PI это static- свойство объекта Math, оно всегда записывается Math.PI, а не как свойство Math-объекта, созданного Вами.
метод объекта Math, он всегда
Поскольку pow это static- метод объекта Math, он всегда записывается Math.pow(), а не как метод Math-объекта, созданного Вами.
метод объекта Math, он всегда
Поскольку random это static- метод объекта Math, он всегда записывается Math.random(), а не как метод Math-объекта, созданного Вами.
Если дробная часть number равна
Если дробная часть number равна .5 или больше, аргумент округляется в сторону увеличения. Если дробная часть number меньше .5, аргумент округляется в сторону уменьшения.
Поскольку round это static-метод объекта Math, он всегда записывается Math.round(), а не как метод Math-объекта, созданного Вами.
Метод sin возвращает числовое значение
Метод sin возвращает числовое значение в диапазоне от -1 до 1, которое представляет собой синус аргумента.
Поскольку sin это static-метод объекта Math, он всегда записывается Math.sin(), а не как метод Math-объекта, созданного Вами.
метод объекта Math, он всегда
Если значение number - отрицательное, sqrt возвращает NaN.
Поскольку sqrt это static- метод объекта Math, он всегда записывается Math.sqrt(), а не как метод Math-объекта, созданного Вами.
свойство объекта Math, оно всегда
Поскольку SQRT1_2 это static- свойство объекта Math, оно всегда записывается Math.SQRT1_2, а не как свойство Math-объекта, созданного Вами.
свойство объекта Math, оно всегда
Поскольку SQRT2 это static- свойство объекта Math, оно всегда записывается Math.SQRT2, а не как свойство Math-объекта, созданного Вами.
Метод tan возвращает числовое значение
Метод tan возвращает числовое значение - тангенс угла.
Поскольку tan это static-метод объекта Math, он всегда записывается Math.tan(), а не как метод Math-объекта, созданного Вами.
объект является элементом массива mimeTypes.
Каждый MimeType- объект является элементом массива mimeTypes. Массив mimeTypes является свойством двух объектов: navigator и Plugin. Например, в таблице дано резюме по значениям для вывода JPEG-изображений:
| navigator.mimeTypes["image/jpeg"].type |
image/jpeg |
| navigator.mimeTypes["image/jpeg"].description |
JPEG Image |
| navigator.mimeTypes["image/jpeg"].suffixes |
jpeg, jpg, jpe, jfif, pjpeg, pjp |
| navigator.mimeTypes["image/jpeg"].enabledPlugins |
null |
Используйте свойство enabledPlugin для определения
Используйте свойство enabledPlugin для определения plug-in'а, сконфигурированного для специфического MIME-типа. Каждый plug-in может поддерживать несколько MIME-типов, и каждый MIME-тип может потенциально поддерживаться несколькими plug-in'ами. Однако только один plug-in может быть сконфигурирован для MIME-типа. (В системах Macintosh и Unix пользователь может конфигурировать обработчик для каждого MIME-тип; в Windows обработчик определяется при старте браузера.)
Свойство enabledPlugin является ссылкой на Plugin-объект, который представляет plug-in, сконфигурированный для специфицированного MIME-типа.
Вам может понадобиться узнать, который plug-in сконфигурирован для MIME-типа, например, чтобы динамически вводить тэг EMBED на страницу, если пользователь имеет plug-in, сконфигурированный для данного MIME-типа.
Свойство suffixes это строка, состоящая
Свойство suffixes это строка, состоящая из правильных расширений (обычно из трёх символов), разделённых запятыми. Например, расширения для MIME-типа "audio/x-midi" будут "mid, midi".
Используйте объект navigator для определения
Используйте объект navigator для определения версии используемого Navigator'а (браузера), какие MIME-типы может обрабатывать Navigator пользователя и какие plug-in'ы установлены у пользователя. Все свойства объекта navigator - только для чтения/read-only.
платформа на которой работает Navigator.
Свойство appVersion специфицирует информацию о версии в следующем формате:
releaseNumber (platform; country) Содержащиеся значения:
releaseNumber - номер версии Navigator'а. Например, "2.0b4" специфицирует Navigator 2.0, beta 4. platform - платформа на которой работает Navigator. Например, "Win16" специфицирует 16-битную версию Windows, такую как Windows 3.1. country это либо "I" для международной версии, либо "U" - для релиза США. Релиз для США имеет более надёжное кодирование информации, чем международный релиз.
javaEnabled возвращает true, если Java
javaEnabled возвращает true, если Java включён; иначе - false. Пользователь может включить и отключить Java в установках пользователя.
символьный код, указывающий также подтип
Значение языка/language это обычно 2-буквенный код, такой как "en", иногда - 5- символьный код, указывающий также подтип языка, такой как "zh_CN".
Используйте это свойство для определения языка клиентского программного обеспечения Navigator'а. Например, Вы можете отобразить пользователю локализованный текст.
Значения платформ: Win32, Win16, Mac68k,
Значения платформ: Win32, Win16, Mac68k, MacPPC и различные варианты Unix.
Тип машины, для которого Navigator скомпилирован, может отличаться от реального типа машины по причине различий версий, разных эмуляторов или по другим показателям.
Если Вы используете SmartUpdate для загрузки программного обеспечения на пользовательскую машину, Вы можете использовать это свойство, чтобы убедиться, что тригер загружает соответствующие JAR-файлы. Страница-переключатель/тригер проверяет версию Navigator'а перед проверкой свойства platform. Об использовании SmartUpdate см. Using JAR Installation Manager for SmartUpdate.
Этот метод возвращает значение настройки.
Этот метод возвращает значение настройки. Если Вы используете этот метод для установки настройки, он возвращает новое значение.
При наличии разрешения Вы можете получать и устанавливать настройки, показанные в таблице:
Таблица 1.2Настройки.
|
Автоматически загрузить изображения | general.always_load_images | true или false |
|
Включить Java | security.enable_java | true или false |
|
Включить JavaScript | javascript.enabled | true или false |
|
Включить таблицы стилей | browser.enable_style_sheets | true или false |
|
Включить SmartUpdate | autoupdate.enabled | true или false |
|
Принимать все куки/cookies | network.cookie.cookieBehavior | 0 |
|
Принимать только куки, которые отправляются обратно серверу | network.cookie.cookieBehavior | 1 |
|
Отключить куки | network.cookie.cookieBehavior | 2 |
|
Предупреждать перед получением куки | network.cookie.warnAboutCookies | true или false |
