Ядро JavaScript 1.5. Справочник

         

Ядро JavaScript 1.5. Справочник


Метод. Запрашивает значение свойства объекта в JavaScript. Эквивалентен "this.name" в JavaScript.


Объявление

public Object getMember(String name)



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getMilliseconds()

Параметры

Отсутствуют.

Описание

getMilliseconds возвращает значение - число в диапазоне от 0 до 999.

Примеры

Следующий пример присваивает миллисекундную часть текущего времени переменной ms.



var ms;
Today = new Date();
ms = Today.getMilliseconds();

См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис
getMinutes()

Параметры

Отсутствуют.


Описание

getMinutes возвращает значение - целое в диапазоне от 0 до 59.


Примеры

Второй оператор присваивает 15 переменной minutes, базируясь на значении Date-объекта Xmas95.

Xmas95 = new Date("December 25, 1995 23:15:00")

minutes = Xmas95.getMinutes()


См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262


Синтаксис

getMonth()

Параметры

Отсутствуют.

Описание

getMonth возвращает значение - целое в диапазоне от 0 до 11.

0 соответствует January/январю, 1 - February/февралю, и так далее.


Примеры

Второй оператор присваивает 11 переменной month, базируясь на значении Date-объекта Xmas95.

Xmas95 = new Date("December 25, 1995 23:15:00")

month = Xmas95.getMonth()


См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262


Синтаксис

getSeconds()

Параметры

Отсутствуют.


Описание

getSeconds возвращает значение - целое в диапазоне от 0 до 59.


Примеры

Второй оператор присваивает значение 30 переменной secs, базируясь на значении Date-объекта Xmas95.

Xmas95 = new Date("December 25, 1995 23:15:30")

secs = Xmas95.getSeconds()


См. также

, .



Ядро JavaScript 1.5. Справочник


Метод. Запрашивает значение элемента массива объекта в JavaScript. Эквивалентен "this[index]" в JavaScript.

Объявление
public Object getSlot(int index)



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262


Синтаксис

getTime()

Параметры

Отсутствуют.

Описание

Метод getTime возвращает значение - количество миллисекунд, прошедших после 1 января 1970 года, 00:00:00. Вы можете использовать этот метод, чтобы помочь назначить дату и время другому объекту Date.


Примеры

В этом примере значение даты theBigDay присваивается sameAsBigDay:

theBigDay = new Date("July 1, 1999")
sameAsBigDay = new Date()

sameAsBigDay.setTime(theBigDay.getTime())


См. также

, .





Ядро JavaScript 1.5. Справочник


Возвращает смещение часового пояса в минутах для данной местности.

Метод из

РеализованJavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262

Синтаксис
getTimezoneOffset()

Параметры

Отсутствуют.

Описание

Смещение часового пояса это разница между местным временем и Greenwich Mean Time (GMT)/временем по Гринвичу. Переход на летнее время не даёт этому значению быть постоянным.

Примеры
x = new Date()

currentTimeZoneOffsetInHours = x.getTimezoneOffset()/60



Ядро JavaScript 1.5. Справочник


Возвращает день (число) месяца в специфицированной дате в соответствии с универсальным временем.

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getUTCDate()

Параметры

Отсутствуют.

Описание

getUTCDate возвращает целое в диапазоне от 1 до 31.


Примеры

В этом примере часть дня из текущей даты присваивается переменной d.

var d;
Today = new Date();
d = Today.getUTCDate();

См. также

, , .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getUTCDay()

Параметры

Отсутствуют.

Описание

getUTCDay возвращает целое, соответствующее дню недели: 0 - воскресенье, 1 - понедельник, 2 - вторник, и так далее.


Примеры

В этом примере часть дня недели текущей даты присваивается переменной ms.

var weekday;
Today = new Date()

weekday = Today.getUTCDay()


См. также

, , .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getUTCFullYear()

Параметры

Отсутствуют.

Описание

getUTCFullYear возвращает абсолютное число, совместимое с year-2000, например, 1995.

Примеры

В этом примере значение из 4 цифр, текущий год, присваивается переменной yr.

var yr;
Today = new Date();

yr = Today.getUTCFullYear();


См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getUTCHours()

Параметры

Отсутствуют.

Описание

getUTCHours возвращает целое в диапазоне от 0 до 23.


Примеры

В примере часть "часы" текущего времени присваивается переменной hrs.

var hrs;
Today = new Date();
hrs = Today.getUTCHours();

См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getUTCMilliSeconds()

Параметры

Отсутствует.

Описание

getUTCMilliseconds возвращает целое в диапазоне от 0 до 999.


Примеры

В этом примере часть миллисекунд текущего времени присваивается переменной ms.

var ms;
Today = new Date();

ms = Today.getUTCMilliseconds();


См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getUTCMinutes()

Параметры

Отсутствуют.

Описание

getUTCMinutes возвращает целое в диапазоне от 0 до 59.


Примеры

В примере часть "минуты" текущего времени присваивается переменной min.

var min;
Today = new Date();

min = Today.getUTCMinutes();


См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3

Версия ECMA

ECMA-262

Синтаксис
getUTCMonth()

Параметры

Отсутствуют.

Описание

getUTCMonth возвращает целое число в диапазоне от 0 до 11, соответствующее месяцу. 0 - январь, 1 - ; февраль, 2 - март, и так далее.

Примеры

В этом примере часть "месяц" текущей даты присваивается переменной mon.

var mon;

Today = new Date();
mon = Today.getUTCMonth();


См. также

, .



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.3Версия ECMA

ECMA-262

Синтаксис
getUTCSeconds()

Параметры

Отсутствуют.

Описание

getUTCSeconds возвращает целое в диапазоне от 0 до 59.

Примеры

В этом примере часть "секунды" текущего времени присваивается переменной sec.

var sec;
Today = new Date();

sec = Today.getUTCSeconds();


См. также

, .



Ядро JavaScript 1.5. Справочник


Static-метод. Возвращает JSObject для окна, содержащего данный аплет. Этот метод используется только в клиентском JavaScript.

Объявление

public static JSObject getWindow(Applet applet)



Ядро JavaScript 1.5. Справочник


getWrappedException - метод экземпляра.


Объявление

public Object getWrappedException()


Описание

getWrappedException() возвращает объект, представляющий значение, которое JavaScript реально отловил. JavaScript может отлавливать значения любых типов. Используйте getWrappedException() для определения вида значения, которое представляет return-тип Object'а.




Ядро JavaScript 1.5. Справочник


getWrappedExceptionType - метод экземпляра.


Объявление

public int getWrappedExceptionType()


Описание

getWrappedExceptionType()

возвращает int, которое совпадает с одним из следующих static int, объявленных классом JSException:

EXCEPTION_TYPE_EMPTY

EXCEPTION_TYPE_VOID

EXCEPTION_TYPE_OBJECT

EXCEPTION_TYPE_FUNCTION

EXCEPTION_TYPE_STRING

EXCEPTION_TYPE_NUMBER

EXCEPTION_TYPE_BOOLEAN


 

    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.



Ядро JavaScript 1.5. Справочник


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

Метод из

Реализован в

JavaScript 1.0, NES 2.0

JavaScript 1.3: не рекомендуется использовать; getYear возвращает год минус 1900 независимо от специфицированного года.

Версия ECMA

ECMA-262

Синтаксис
getYear()

Параметры

Отсутствуют.

Описание

getYear больше не используется и заменён методом .

Метод getYear возвращает год минус 1900; таким образом:

Для лет больше 2000, возвращаемое методом getYear значение будет 100 или больше. Например, если это 2026 год, getYear вернёт 126.

Для лет от 1900 до 1999 включительно, getYear вернёт значение от 0 до 99. Например, если это 1976 год, getYear возвращает 76.

Для лет меньше 1900 или больше 1999, getYear возвращает значение меньше нуля 0. Например, если это 1800 год, getYear возвращает - 100.

Чтобы использовать годы до и после 2000, Вы должны использовать вместо getYear, чтобы год был полностью специфицирован.


Обратная Совместимость

JavaScript 1.2 и более ранние версии.

Метод getYear возвращает 2-х или 4-значный год:

Для лет между 1900 и 1999 включительно, getYear возвращает год минус 1900. Например, если это 1976 год, возвращается 76.

Для лет меньше 1900 или больше 1999, getYear возвращает 4-значное число - год. Например, если это 1856 год, возвращается значение 1856. Если это 2026 год, возвращается 2026.

Примеры
Пример 1.

Второй оператор присваивает значение 95 переменной year.

Xmas = new Date("December 25, 1995 23:15:00")

year = Xmas.getYear() // возвращает 95

Пример 2.

Второй оператор присваивает 100 переменной year.

Xmas = new Date("December 25, 2000 23:15:00")

year = Xmas.getYear() // возвращает 100

 

Пример 3.

Второй оператор присваивает -100 переменной year.

Xmas = new Date("December 25, 1800 23:15:00")

year = Xmas.getYear() // возвращает -100

 

Пример 4.

Второй оператор присваивает 95 переменной year, представляя 1995 год.

Xmas.setYear(95)

year = Xmas.getYear() // возвращает 95


См. также

, , .



Объекты, Методы и Свойства




Эта глава документирует все объекты JavaScript и их методы и свойства. Это алфавитный справочник по главным возможностям JavaScript.

Справочник организован так:

Полные статьи по каждому объекту появляются в алфавитном порядке; свойства и функции, не ассоциированные с каким-либо объектом, даны в  Каждая статья содержит полное описание объекта. Таблицы, включённые в описание каждого объекта, резюмируют свойства и методы объекта.

Полные статьи по свойствам и методам объекта появляются в алфавитном порядке после статьи об объекте.

Эти статьи предоставляют полное описание каждого метода или свойства и содержат перекрёстные ссылки на другие возможности, рассматриваемые в данной документации. 

    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.



Операторы


В этой главе рассматриваются все операторы JavaScript.
Оператор JavaScript состоит из ключевого слова, используемого с соответствующим синтаксисом.

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

Соглашения по синтаксису: все ключевые слова показаны жирным шрифтом. Слова шрифта italic представляют определяемые пользователем имена или операции. Части в квадратных скобках [ ] являются необязательными.

{statements} это блок операторов, который может состоять из 0 или более операторов и заключён в фигурные скобки { }.

В таблице перечислены операторы JavaScript.


Таблица 3.1 &nbsp&nbsp Операторы JavaScript

Прерывает текущий цикл while или for и передаёт управление следующему после цикла оператору.

Объявляет глобальную константу, инициализируя её (по выбору/optionally) значением.

Прерывает выполнение блока операторов в цикле while или for и начинает выполнение следующей итерации цикла.

Выполняет операторы, пока тестовое условие не станет false. Операторы выполняются как минимум один раз.

Даёт возможность обозначенному/signed скрипту предоставлять свойства, функции и объекты другим обозначенным или необозначенным/unsigned скриптам.

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

Итерирует специфицированную переменную по всем свойствам объекта. Для каждого отдельного свойства JavaScript выполняет специфицированные операторы.

Объявляет функцию со специфицированными параметрами. В качестве параметров могут быть строки, числа и объекты.

Выполняет набор операторов, если специфицированное условие true. Если условие false, может быть выполнен другой набор операторов.

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

Идентификатор, который может использоваться совместно с break или continue для указания на точку продолжения выполнения программы.

Специфицирует значение, возвращаемое функцией.

Даёт возможность программе вычислять выражение и искать совпадение значения выражения с меткой case.

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

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

Объявляет переменную, инициализируя её, по выбору, значением.

Создаёт цикл, который вычисляет выражение, и, если оно true, выполняет блок операторов. Затем цикл повторяется до тех пор, пока специфицированное условие true.

Устанавливает объект по умолчанию для набора выполняемых операторов.



Операции




В JavaScript имеются операции присваивания, сравнения, арифметические, битовые, логические, строковые и специальные. В этой главе описаны операции и содержится информация о приоритете операций.

В следующей таблице содержится резюме по операциям JavaScript.

Таблица 5.1 &nbsp&nbsp Операции JavaScript.

Категория Операции

Операция

Описание

+(Сложение) Складывает 2 числа.

++

(Инкремент/Увеличение) добавляет единицу к переменной, представляющей число (возвращая новое или старое значение переменной).

-

(Унарное отрицание, вычитание) Как унарная операция выполняет отрицание аргумента. Как бинарная операция, выполняет вычитание 2 чисел.

--(Декремент/Уменьшение) Вычитает единицу из переменной, представляющей число (возвращает новое или старое значение переменной).

*(Умножение) Перемножает два числа.

/

(Деление) Выполняет деление одного числа на другое.

%(Модулус) Вычисляет целочисленный остаток от деления двух чисел.

+(Конкатенация) Объединяются/складываются две строки.

+=

Конкатенация двух строк и присвоение результата первому операнду.

&&

(Логическое И) Возвращает первый операнд, если он может быть конвертирован в false; иначе, возвращает второй операнд. Таким образом, при использовании с Boolean-значениями, && возвращает true, если оба операнда true; иначе, возвращает false.

(Логическое ИЛИ) Возвращает первый операнд, если он может быть конвертирован в true; иначе, возвращает второй операнд. Таким образом, при использовании с Boolean-значениями, возвращает true, если один из операндов true; если оба false, возвращает false.

!(Логическое НЕТ) Возвращает false, если его единственный операнд может быть конвертирован в true; иначе, возвращает true.

&

(Побитовое И) Возвращает 1 в битовой позиции, если биты обоих операндов являются единицами.

^

(Побитовое исключающее ИЛИ) Возвращает 1 в битовой позиции, если бит одного, но не обоих операндов являются единицами.|

(Побитовое ИЛИ) Возвращает 1 в битовой позиции, если бит любого операнда равен 1.~

(Побитовое НЕ) Побитовое отрицание операнда.

<<

(Сдвиг влево) Сдвигает первый операнд в битовом представлении влево на количество битов, специфицированное вторым операндом, заполняя слева.

>>(Сдвиг вправо с сохранением знака) Сдвигает первый операнд в битовом представлении вправо на количество битов, специфицированное вторым операндом, отбрасывая смещённые биты.

>>>(Сдвиг вправо с заполнением нулями) Сдвигает первый операнд в битовом представлении вправо на количество битов, специфицированное вторым операндом, отбрасывая смещённые биты и заполняя слева нулями.

=Присваивает первому операнду значение второго операнда.

+=

Складывает два числа и присваивает результат первому операнду.

-=Вычитает одно число из другого и присваивает результат первому операнду.

*=

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

/=Делит одно число на другое и присваивает результат первому операнду.

%=

Вычисляет целочисленный результат от деления двух чисел и присваивает результат первому операнду.

&=

Выполняет побитовое И и присваивает результат первому операнду.

^=Выполняет побитовое исключающее ИЛИ и присваивает результат первому операнду.

|=Выполняет побитовое ИЛИ и присваивает результат первому операнду.

<<=Выполняет сдвиг влево и присваивает результат первому операнду.

>>=Выполняет сдвиг вправо с сохранением знака и присваивает результат первому операнду.

>>>=

Выполняет сдвиг вправо с заполнением нулями и присваивает результат первому операнду.

==Возвращает true, если операнды равны.!=

Возвращает true, если операнды не равны.

===

Возвращает true, если операнды равны и одного типа.

!==Возвращает true, если операнды не равны и/или не одного типа.>

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

>=

Возвращает true, если левый операнд больше или равен правому операнду.

<

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

<=Возвращает true, если левый операнд меньше или равен правому операнду.

?Выполняет обычный "if...then...else".

,

Вычисляет два выражения и возвращает результат второго.

Удаляет объект, свойство объекта или элемент по специфицированному индексу в массиве.

Определяет анонимную функцию.

Возвращает true, если специфицированное свойство имеется в специфицированном объекте.

Возвращает true, если специфицированный объект имеет специфицированный тип объекта.

Создаёт экземпляр определённого пользователем типа объекта или одного из встроенных типов объекта.

Ключевое слово, используемое для обращения к текущему объекту.

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

Специфицирует выражение, вычисляемое без возвращения значения.


 



Классы, Конструкторы и Методы Java


Эта глава документирует Java-классы, используемые для LiveConnect, и их конструкторы и методы.

Имеется алфавитная ссылка на классы, которая даёт доступ Java-объектам к коду скриптов JavaScript.

Эта ссылка организована так:

Полные вхождения для каждого класса появляются в алфавитном порядке.

Таблицы, включённые в описание каждого класса, суммирую конструкторы и методы класса.

Полные вхождения для конструкторов и методов класса появляются в алфавитном порядке после вхождения класса.

    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября  2000 г.



Ядро JavaScript 1.5. Справочник


Используется ли флаг "g" с регулярным выражением.

Свойство изЭкземпляры .

Read-onlyРеализовано в

JavaScript 1.2, NES 3.0Версия ECMA

ECMA 262, Edition 3

Описание

global это свойство отдельного объекта регулярного выражения.

Значение global будет true, если флаг "g" был использован; иначе, false. Флаг "g" указывает, что должно быть протестировано относительно всех возможных совпадений в строке.

Вы не можете изменить это свойство явно.



If...else


Выполняет набор операторов, если специфицированное условие true. Если условие false, может быть выполнен другой набор операторов.

Реализован в

JavaScript 1.0, NES 2.0

Версия ECMA

ECMA-262


Синтаксис

if (condition) {

   statements1

}

[else {

   statements2

}]

 

Параметры

condition

Условие. Может быть любым выражением JavaScript, которое вычисляется в true или false. Должно быть заключено в скобки. Если true, выполняются операторы statements1.

statements1,

statements2

Любые операторы JavaScript, включая вложенные if. Несколько операторов обязаны быть заключены в фигурные скобки.


Описание

Вы не должны использовать операции присвоения в условном операторе. Например, не используйте такой код:

if(x = y)

{

   /* делайте правильно */

}

Если Вам необходимо использовать присвоение в условном операторе, добавьте дополнительные скобки вокруг операции присвоения. Например, if( (x = y) ).


Примеры

if (cipher_char == from_char) {

   result = result + to_char

   x++}

else

   result = result + clear_char



IgnoreCase


Используется ли флаг "i" с регулярным выражением.

Свойство изЭкземпляры .

Read-only

Реализовано вJavaScript 1.2, NES 3.0

Версия ECMAECMA 262, Edition 3

Описание

ignoreCase это свойство отдельного объекта регулярного выражения.

Значение ignoreCase будет true, если флаг "i" был использован; иначе, false. Флаг "i" указывает, что регистр должен игнорироваться при попытках совпадений в строке.

Вы не можете изменить это свойство явно.



Import


Даёт возможность скриптам импортировать свойства, функции и объекты из обозначенного/signed скрипта, экспортирующего информацию.

Эта возможность отсутствует в ECMA 262, Edition 3.

Реализован в JavaScript 1.2, NES 3.0


Синтаксис

import objectName.name1, objectName.name2, ..., objectName.nameN

import objectName.*


Параметры

objectName

Имя объекта, который будет получать импортируемые имена.

name1,

name2,

nameN Список импортируемых из файла экспорта свойств, функций и объектов .

*

Импортируются все свойства, функции и объекты их экспортирующего скрипта.


Описание

Параметр objectName это имя объекта, который будет получать импортируемые имена. Например, если f и p экспортируются и если obj это объект импортирующего скрипта, следующий код делает f и p доступными в импортирующем скрипте как свойства объекта obj.

import obj.f, obj.p

Обычно информация в обозначенном/signed скрипте доступна только скриптам, обозначенным теми же принципалами/principals. Экспортируя (используя оператор ) свойства, функции и объекты, обозначенный скрипт делает эту информацию доступной любому скрипту (signed или unsigned). Импортирующий скрипт использует оператор import для доступа к этой информации.

Скрипт обязан загрузить экспортирующий скрипт в окно, фрэйм или слой/layer, прежде чем сможет импортировать и использовать любые экспортируемые свойства, функции и объекты.


См. также

.



In



Операция in возвращает true, если специфицированное свойство имеется в специфицированном объекте.

Реализована вJavaScript 1.4


Синтаксис

propNameOrNumber in objectName


Параметры

propNameOrNumber

Строка или числовое выражение, представляющее имя свойства или индекс массива.

objectNameИмя объекта.


Описание

Некоторые примеры использования операции in:

// Массивы

trees=new Array("redwood","bay","cedar","oak","maple")

0 in trees        // возвращает true

3 in trees        //

возвращает true

6 in trees        //

возвращает

false

"bay" in trees    //

возвращает

false (Вы обязаны специфицировать номер индекса,

                  // а не значение по этому индексу)

"length" in trees //

возвращает

true (length это свойство Array)

// Предопределённые объекты

"PI" in Math          //

возвращает

true

myString=new String("coral")

"length" in myString  //

возвращает true

// Специальные объекты

mycar = {make:"Honda",model:"Accord",year:1998}

"make" in mycar  //

возвращает

true

"model" in mycar //

возвращает true

Вы обязаны специфицировать объект справа от операции in. Например, Вы можете специфицировать строку, созданную конструктором String, но не можете специфицировать строковой литерал.

color1=new String("green")

"length" in color1 //

возвращает true

color2="coral"

"length" in color2 //генерирует ошибку (coral это не String-объект)

 

Использование in с удалёнными или undefined свойствами.

Если Вы удаляете свойство операцией delete, операция in возвратит false для данного свойства.

mycar = {make:"Honda",model:"Accord",year:1998}

delete mycar.make

"make" in mycar  //

возвращает false

trees=new Array("redwood","bay","cedar","oak","maple")

delete trees[3]

3 in trees //

возвращает false

Если Вы устанавливаете свойство в undefined, но не удаляете его, операция in возвращает true для этого свойства.

mycar = {make:"Honda",model:"Accord",year:1998}

mycar.make=undefined

"make" in mycar  //

возвращает true

trees=new Array("redwood","bay","cedar","oak","maple")

trees[3]=undefined

3 in trees //

возвращает true

Об использовании операции in

с удалёнными элементами массива см. .



объекта возвращает индекс первого появления


Внутри вызывающего String- объекта возвращает индекс первого появления специфицированного значения, начиная поиск с fromIndex, или с -1, если значение не найдено.

Метод из Реализован вJavaScript 1.0, NES 2.0 Версия ECMA ECMA-262
Синтаксис

indexOf(searchValue[, fromIndex])
Параметры


searchValue

Строка, представляющая значение для поиска.fromIndex Место в вызывающей строке, с которого начинается поиск. Это может быть целое число в диапазоне от 0 и до конца строки. Значение по умолчанию 0.

Описание

Символы в строке индексируются слева направо. Индекс первого символа 0, а индекс последнего символа строки, называемый StringName, это StringName.length - 1.
"Blue Whale".indexOf("Blue")    // возвращает 0

"Blue Whale".indexOf("Blute")   // возвращает -1

"Blue Whale".indexOf("Whale",0) // возвращает 5

"Blue Whale".indexOf("Whale",5) // возвращает 5

"Blue Whale".indexOf("",9)      // возвращает 9

"Blue Whale".indexOf("",10)     // возвращает 10

"Blue Whale".indexOf("",11)     // возвращает 10
Метод indexOf чувствителен к регистру. Например, следующее выражение возвращает -1:
"Blue Whale".indexOf("blue")
Примеры

Пример 1.

Этот пример использует indexOf и lastIndexOf для локализации значений в строке "Brave new world."
var anyString="Brave new world"
// Отображает 8

document.write("<P>The index of the first w from the beginning is " +

   anyString.indexOf("w"))

// Отображает 10

document.write("<P>The index of the first w from the end is " +

   anyString.lastIndexOf("w"))

// Отображает 6

document.write("<P>The index of 'new' from the beginning is " +

   anyString.indexOf("new"))

// Отображает 6

document.write("<P>The index of 'new' from the end is " +

   anyString.lastIndexOf("new"))
Пример 2.

Этот пример определяет две строковые переменные. Эти переменные содержат одинаковые строки, но во второй строке буквы введены в верхнем регистре. Первый метод writeln выводит 19. Но, поскольку метод indexOf чувствителен к регистру, строка "cheddar" в строке myCapString не будет найдена, поэтому второй метод writeln выводит -1.
myString="brie, pepper jack, cheddar"

myCapString="Brie, Pepper Jack, Cheddar"

document.writeln('myString.indexOf("cheddar") is ' +

   myString.indexOf("cheddar"))

document.writeln('<P>myCapString.indexOf("cheddar") is ' +

   myCapString.indexOf("cheddar"))
Пример 3.

Этот пример устанавливает count в число появлений буквы x в строке str:
count = 0;

pos = str.indexOf("x");

while ( pos != -1 ) {

   count++;

   pos = str.indexOf("x",pos+1);

}


См. также

, , .

++ (Инкремент/Увеличение)


Операция инкремента используется так:

var++  или  ++var

Выполняет инкремент (добавляет единицу) своего операнда и возвращает значение. Если используется как постфикс, операция после операнда (например, x++), затем возвращает значение, бывшее до инкремента. Если используется как префикс, операция

перед операндом (например, ++x), тогда возвращает, после выполнения инкремента, новое значение.

Например, если x равен 3, тогда операция y = x++ устанавливает y в 3 и увеличивает x до 4. Если x равен 3, то операция y = ++x выполняет инкремент x до 4 и устанавливает y в 4.



Input


Для массива, созданного путём совпадения с регулярным выражением, отражает строку-оригинал, относительно которой выполнялся поиск совпадений.

Свойство из

StaticРеализовано в

JavaScript 1.2, NES 3.0



Instanceof


Операция instanceof возвращает true, если специфицированный объект имеет специфицированный тип.

Реализована вJavaScript 1.4


Синтаксис

objectName instanceof objectType


Параметры

objectName

Имя объекта для сравнения с objectType.objectType Тип объекта.


Описание

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

Вы обязаны специфицировать объект справа от операции instanceof. Например, Вы можете специфицировать строку, созданную с помощью конструктора String, но не можете специфицировать строковой литерал.

color1=new String("green")

color1 instanceof String //

возвращает true

color2="coral"

color2 instanceof String //

возвращает false (coral не является String-объектом)


Примеры
 

См. также примеры для .

 

Пример 1.

В этом коде instanceof

используется для определения, является ли theDay Date -объектом. Поскольку theDay является Date -объектом, операторы в операторе if

выполняются.

theDay=new Date(1995, 12, 17)

if (theDay instanceof Date) {

   // выполняемые операторы

}

 

Пример 2.

В этом коде instanceof

используется для демонстрации того, что объекты String

и Date имеют также тип Object (они получены из Object).

myString=new String()

myDate=new Date()

myString instanceof String // возвращает true

myString instanceof Object //

возвращает

true

myString instanceof Date   //

возвращает false

myDate instanceof Date     //

возвращает true

myDate instanceof Object   //

возвращает true

myDate instanceof String   //

возвращает false

 

Пример 3.

В это коде создаётся тип объектов Car и экземпляр этого типа объектов, mycar. Операция instanceof демонстрирует, что объект mycar имеет тип Car и тип Object.

function Car(make, model, year) {

   this.make = make

   this.model = model

   this.year = year

}

mycar = new Car("Honda", "Accord", 1998)

a=mycar instanceof Car // возвращает true

b=mycar instanceof Object //

возвращает true



Italics


Выводит строку шрифтом italic, как при использовании тэга <I>.

Метод из

Реализован вJavaScript 1.0, NES 2.0


Синтаксис

italics()

Параметры

Отсутствуют.


Описание

Используйте метод italics с методами write или writeln для форматирования и отображения строки в документе. В серверном JavaScript используйте для отображения строки функцию write.


Примеры


В этом примере используются методы работы со строками для изменения форматирования строки:

var worldString="Hello, world"

document.write(worldString.blink())

document.write("<P>" + worldString.bold())

document.write("<P>" + worldString.italics())

document.write("<P>" + worldString.strike())

Вывод будет таким же, как и в нижеследующем HTML:

<BLINK>Hello, world</BLINK>

<P><B>Hello, world</B>

<P><I>Hello, world</I>

<P><STRIKE>Hello, world</STRIKE>

См. также

, , .



Ядро JavaScript 1.5. Справочник.




Английский               H      K                            Y 

Русский                                              



Ядро JavaScript. Справочник.


Оригинал этого справочника (на английском языке) и другие

спецификации от Netscape можно найти по адресу:

Перевод на русский язык выполнил Александр Пирамидин.

Ваши замечания и предложения направляйте по e-mail:

Эта книга является справочником по ядру языка JavaScript версии 1.5.

JavaScript это созданный  Netscape платформонезависмый объектно-базирующийся язык скриптинга (сценариев). Ядро JavaScript может быть расширено за счёт дополнения его новыми объектами.



Java


Объект верхнего уровня, используемый для доступа к любым классам Java пакета java.*.

Объект ядраРеализован в

JavaScript 1.1, NES 2.0


Создание

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


Описание

Объект java это синоним свойства Packages.java.

См. также

, .


    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.


Любой класс Java-пакета java.*.

Свойство из

Реализовано в

JavaScript 1.1, NES 2.0

Синтаксис
Packages.java

Описание

Используйте свойство java для доступа к любому классу пакета java из кода JavaScript. Заметьте, что объект верхнего уровня java

является синонимом Packages.java.


Примеры

Следующий код получает в JavaScript доступ к конструктору класса java.awt.Frame:

var theOwner = new Packages.java.awt.Frame();

Вы можете упростить этот код путём использования использования объекта java верхнего уровня для доступа к конструктору:

var theOwner = new java.awt.Frame();



JavaArray


Объект-капсула, Java-массив, доступ к которому осуществляется из кода JavaScript, является членом типа JavaArray.

Объект ядра Реализован в

JavaScript 1.1, NES 2.0


Создание

Любой Java-метод, возвращающий массив. Кроме того, Вы можете создать JavaArray из данных произвольного типа, используя метод newInstance класса Array:

public static Object newInstance(Class componentType,

   int length)
   throws NegativeArraySizeException


Описание

Объект JavaArray является экземпляром массива Java, который создаётся в или передаётся в JavaScript. JavaArray это капсула для экземпляра; все ссылки на этот экземпляр массива осуществляются через JavaArray.

В JavaScript 1.4 и позднее параметр componentType это JavaClass-объект или объект, представляющий тип массива или объект класса, такой как возвращаемый из java.lang.Class.forName. В JavaScript 1.3 и ранее componentType обязан быть объектом класса.

Для доступа к элементам JavaArray-объекта используются индексы с базой 0, точно так, как Вы получаете доступ к элементам 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 1.4 и позднее методы из java.lang.Object наследуются в JavaArray.


Обратная Совместимость

JavaScript 1.3 и ранее.

Методы из java.lang.Object не наследуются в JavaArray. Кроме того, метод toString наследуется из объекта Object и возвращает следующее значение:

[object JavaArray]

Вы обязаны специфицировать объект класса, такой как возвращаемый из java.lang.Object.forName, для параметра componentType метода newInstance, если Вы используете этот метод для создания массива. Вы не можете использовать объект JavaClass для параметра componentType.


 

Свойство. Резюме.

Свойство

Описание

Количество элементов в Java-массиве, представленное объектом JavaArray.


 

Метод. Резюме.

Метод

Описание

В JavaScript 1.4 этот метод переопределён унаследованным методом java.lang.Object.toString.

В JavaScript 1.3 и ранее этот метод возвращает строку, идентифицирующую объект как JavaArray.

В JavaScript 1.4 и позднее JavaArray также наследует методы суперкласса массива Java, java.lang.Object.


Примеры

Пример 1.

Инстанциация (создание экземпляра) JavaArray в JavaScript.

В этом примере JavaArray byteArray создаётся методом java.lang.String.getBytes, который возвращает массив.

var javaString = new java.lang.String("Hello world!");

var byteArray = javaString.getBytes();

 

Пример 2.

Инстанциация JavaArray в JavaScript методом newInstance.

В JavaScript 1.4 Вы можете использовать объект JavaClass как аргумент для метода newInstance, который создаёт массив, как показано в этом коде:

var dogs = java.lang.reflect.Array.newInstance(java.lang.String, 5)

В JavaScript 1.1 объект класса, возвращаемый методом java.lang.Class.forName, используется как аргумент метода newInstance, как показано в коде:

var dataType = java.lang.Class.forName("java.lang.String")

var dogs = java.lang.reflect.Array.newInstance(dataType, 5)



JavaClass


Ссылка JavaScript на Java-класс.

 

Объект ядра Реализован в

JavaScript 1.1, NES 2.0


Создание

Ссылка на имя класса, используемая в объекте Packages:

Packages.JavaClass

где JavaClass это полное квалифицированное имя Java-класса объекта. Объекты LiveConnect java, sun и netscape

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


Описание

Объект JavaClass это ссылка на один из классов пакета Java, такой как netscape.javascript.JSObject.

Объект JavaPackage это ссылка на пакет Java, такой как netscape.javascript.

В JavaScript иерархия JavaPackage и JavaClass отражает иерархию пакетов и классов Java.

Вы можете передавать объект JavaClass Java-методу, который требует тип аргумента java.lang.Class.


Обратная Совместимость

 

JavaScript 1.3 и ранее.

Вы обязаны создать капсулу-оболочку вокруг экземпляра java.lang.Class до того, как Вы передадите его как параметр Java- методу.

Объекты JavaClass

не конвертируются автоматически в экземпляры класса java.lang.Class.


Свойства. Резюме.

Свойства объекта JavaClass являются static-полями Java-класса.


Метод. Резюме.

Методы объекта JavaClass

являются static-методами Java-класса.


Примеры

 

Пример 1.

Здесь x это объект JavaClass, ссылающийся на java.awt.Font. Поскольку BOLD это static-поле в классе Font, оно также является свойством объекта JavaClass.

x = java.awt.Font
myFont = x("helv",x.BOLD,10) // создаёт Font-объект

Предыдущий пример опускает ключевое слово Packages и использует синоним java, поскольку класс Font находится в пакете java.

 

Пример 2.

Здесь JavaClass-объект java.lang.String

передаётся как аргумент методу newInstance, который создаёт массив:

var cars = java.lang.reflect.Array.newInstance(java.lang.String, 15)


См. также

, , , .

    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.



JavaObject


Тип объекта-капсулы Java, доступ к которому осуществляется из кода JavaScript.

Объект ядра

Реализован вJavaScript 1.1, NES 2.0


Создание

Любой метод Java, возвращающий тип объекта. Кроме того, Вы можете явно конструировать JavaObject

через использование Java-конструктора объекта с ключевым словом Packages:

new Packages.JavaClass(parameterList)

где JavaClass это полное специфицированное имя Java-класса объекта.

Параметры

parameterList

Необязательный список параметров, специфицированный конструктором в Java-классе.

Описание

Объект JavaObject

является экземпляром Java-класса, создаваемым в или передаваемым в JavaScript. JavaObject

это оболочка для экземпляра; все обращения к экземпляру класса делаются через JavaObject.

Любые данные Java, перенесённые в JavaScript, конвертируются в типы данных JavaScript. Если JavaArray передаётся обратно в Java, с массива убирается оболочка, и он может использоваться кодом Java. См. в книге информацию конверсии типов данных.


Свойства. Резюме.

Наследует как свойства членов public-данных Java-класса, экземпляром которого он является. Наследует также как свойства членов public-данных любого суперкласса.


Метод. Резюме.

Наследует public-методы из Java-класса, экземпляром которого он является. JavaObject также наследует методы из java.lang.Object

и любого другого суперкласса.


Примеры

Пример 1. Инстанциация Java-объекта в  JavaScript.

Следующий код создаёт JavaObject theString, который является экземпляром класса java.lang.String:

var theString = new Packages.java.lang.String("Hello, world")

Поскольку класс String находится в пакете java, Вы можете также использовать синоним java и опустить ключевое слово Packages

при инстанциации (создании экземпляра) класса:

var theString = new java.lang.String("Hello, world")

 

Пример 2. Доступ к методам Java-объекта.

Поскольку JavaObject theString является экземпляром класса java.lang.String, он наследует все public-методы класса java.lang.String. В этом примере используется метод startsWith для проверки, начинается ли theString

с "Hello".

var theString = new java.lang.String("Hello, world")

theString.startsWith("Hello") // возвращает true

 

Пример 3. Доступ к унаследованным методам.

Поскольку getClass является методом из Object и java.lang.String расширяет Object, класс String

наследует метод getClass. Следовательно, getClass

является также методом из JavaObject, который инстанциирует String в JavaScript.

var theString = new java.lang.String("Hello, world")

theString.getClass() // возвращает java.lang.String


См. также

, , , .

    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.



JavaPackage


Ссылка JavaScript на Java-пакет.

 

Объект ядра

Реализован в

JavaScript 1.1, NES 2.0


Создание

Ссылка на имя пакета, используемая с ключевым словом Packages:

Packages.JavaPackage

где JavaPackage это имя Java-пакета объекта. Если это пакет в пакетах java, netscape или sun, слово Packages

применять не обязательно.


Описание

В Java пакет это коллекция Java-классов или других Java-пакетов. Например, пакет netscape

содержит пакет netscape.javascript; пакет netscape.javascript содержит классы JSObject

и JSException.

В JavaScript JavaPackage

это ссылка на Java-пакет. Например, ссылка на netscape это JavaPackage. netscape.javascript

это и JavaPackage, и свойство JavaPackage в netscape.

Объект JavaClass является ссылкой на один из классов пакета, такой как netscape.javascript.JSObject. Иерархия JavaPackage и JavaClass отражает иерархию пакетов и классов Java.

Хотя пакеты и классы, содержащиеся в JavaPackage, являются его свойствами, Вы не можете использовать оператор for...in

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


Свойства. Резюме.

Свойства JavaPackage

являются объектами JavaClass и другими JavaPackage-объектами, содержащимися в нём.


Примеры


Предположим, Redwood corporation использует пакет Java redwood для хранения различных Java-классов, реализованных ею. Следующий код создаёт JavaPackage red:

var red = Packages.redwood


См. также

, , , .


    

Copyright © 2000 Все права зарезервированы.

Дата последнего обновления: 28 сентября 2000 г.



Join


Объединяет все элементы массива в строку.

Метод из

Реализован вJavaScript 1.1, NES 2.0

Версия ECMA

ECMA-262


Синтаксис

join(separator)


Параметры

separator

Специфицирует строку для отделения каждого элемента массива. Сепаратор конвертируется в строку, если необходимо. Если отсутствует, элементы массива разделяются запятыми.


Описание

Конверсия с строку всех объединяемых в строку элементов массива.


Примеры

Следующий пример создаёт массив a с тремя элементами, затем объединяет массив трижды: используя сепаратор по умолчанию, запятую и пробел, затем знак "плюс".

a = new Array("Wind","Rain","Fire")

myVar1=a.join()      // присваивает "Wind,Rain,Fire" переменной myVar1

myVar2=a.join(", ")  // присваивает "Wind, Rain, Fire" переменной myVar1

myVar3=a.join(" + ") // присваивает "Wind + Rain + Fire" переменной myVar1

См. также



JSException


public-класс JSException расширяет RuntimeException.

java.lang.Object
|

   +----java.lang.Throwable

            |

            +----java.lang.Exception

                     |

                     +----java.lang.RuntimeException

                                 |

                                 +----netscape.javascript.JSException


Описание

JSException это исключение, вызываемое тогда, когда код JavaScript возвращает ошибку.


Конструктор. Резюме.

Класс netscape.javascript.JSException имеет следующий конструктор:

Конструктор

Описание

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


 

Методы. Резюме.

Класс netscape.javascript.JSException имеет следующие методы:

Метод

Описание

Метод getWrappedException экземпляра.

getWrappedExceptionType

Метод getWrappedExceptionType экземпляра возвращает int-отображение типа объекта wrappedException.

В следующих разделах показано объявление и использование конструкторов и методов.


Обратная Совместимость

JavaScript от 1.1 до 1.3.

JSException имело три public-конструктора, которые по выбору принимали строку-аргумент, специфицирующую детальное сообщения или другую информацию об исключении. Метод getWrappedException

отсутствовал.


Конструкторы, не рекомендуемые для использования в JavaScript 1.4.

Конструирует JSException

с необязательным сообщением о деталях.


Объявление

1. public JSException()

2. public JSException(String s)

3. public JSException(String s,

   String filename,
   int lineno,
   String source,

   int tokenIndex)


Аргументы

s

Сообщение о деталях.

filename

URL файла, в котором возникла ошибка, если возможен.

lineno

номер строки в файле, если возможно.

source

Строка, содержащая вычисляемый код JavaScript.

tokenIndex

индекс в строке-источнике, где возникла ошибка.



JSObject


Класс public final class netscape.javascript.JSObject расширяет Object.

java.lang.Object
   |
   +----netscape.javascript.JSObject


Описание

Объекты JavaScript "обёрнуты"/инкапсулированы в экземпляры класса netscape.javascript.JSObject

и передаются в Java.

JSObject позволяет Java манипулировать объектами JavaScript.

Если объект JavaScript посылается в Java, машина времени выполнения (программ) создаёт Java-оболочку типа JSObject; когда JSObject посылается из Java в JavaScript, машина времени выполнения "разворачивает" его в оригинальный тип объекта JavaScript. Класс JSObject даёт возможность вызывать методы JavaScript и проверять JavaScript-свойства.

Любые данные JavaScript, перенесённые в Java, конвертируются в типы данных Java. Когда JSObject передаётся обратно в JavaScript, объект декапсулируется и может использоваться в коде JavaScript. См. о деталях конверсии типов данных.


Методы. Резюме.

Класс netscape.javascript.JSObject

имеет следующие методы:

Метод

Описание

Вызывает метод JavaScript.

Определяет, ссылаются ли два объекта JSObject на один и тот же экземпляр.

Вычисляет выражение JavaScript.

Запрашивает значение свойства объекта в JavaScript.

Запрашивает значение элемента массива объекта в JavaScript.

Запрашивает свойство объекта в JavaScript.

Устанавливает значение свойства объекта в JavaScript.

Устанавливает значение элемента массива объекта в JavaScript.

Конвертирует JSObject в строку.

Класс netscape.javascript.JSObject имеет следующий статический/static метод:

 

Метод

Описание

Получает JSObject для окна, содержащего данный аплет.

В последующих разделах рассматривается объявление и использование этих методов.



В этой главе дан синтаксис


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

Label


Предоставляет оператор с идентификатором,  позволяющим ссылаться на этот оператор из break или continue.

Реализован в JavaScript 1.2, NES 3.0

Версия ECMA ECMA 262, Edition 3


Например, Вы можете использовать метку для идентификации цикла, а затем использовать операторы break или continue для прерывания или продолжения выполнения цикла.


Синтаксис

label :

   statement

 

Параметр

label

Любой идентификатор JavaScript, кроме зарезервированного слова.

statement Операторы. break может использоваться с любым помеченным оператором, а continue может использоваться с помеченными операторами цикла.


Примеры

Пример помеченного оператора, использующего , см. в . Пример помеченного оператора, использующего , см. в .


См. также

, .



LastIndex


Целочисленное read/write свойство, которое специфицирует индекс, с которого начинается поиск следующего совпадения.

Свойство изЭкземпляры .Реализовано в

JavaScript 1.2, NES 3.0Версия ECMA

ECMA 262, Edition 3

Описание

lastIndex это свойство отдельного объекта регулярного выражения.

Это свойство устанавливается, только если регулярное выражение использует флаг "g" для указания на глобальный поиск. Применяются следующие правила:

Если lastIndex больше, чем размер строки, regexp.test и regexp.exec терпят неудачу, а lastIndex устанавливается в 0.

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

Если lastIndex равен размеру строки и если регулярное выражение не совпадает с пустой строкой, то регулярное выражение не совпадает с вводом, и lastIndex устанавливается 0.

Иначе, lastIndex устанавливается в следующую позицию после самого последнего совпадение.

Например, рассмотрим последовательность следующих операторов:

re = /(hi)?/g

Совпадает с пустой строкой.

re("hi")

Возвращает ["hi", "hi"] с lastIndex, который равен 2.re("hi")

Возвращает [""], пустой массив, чей нулевой элемент является совпавшей строкой. В данном случае это пустая строка, поскольку lastIndex был 2 (и всё ещё равен 2), а "hi" имеет размер 2.



LastIndexOf


Внутри вызывающего String-объекта возвращает индекс первого появления специфицированного значения, или с -1, если значение не найдено. Поиск в вызывающей строке идёт в обратном направлении, начиная с fromIndex.

Метод из

Реализован вJavaScript 1.0, NES 2.0

Версия ECMAECMA-262


Синтаксис

lastIndexOf(searchValue[, fromIndex])

Параметры

searchValue

Срока - значение для поиска.

fromIndex

Место в вызывающей строке, с которого начинается поиск. Это может быть целое число в диапазоне от 0 и до конца строки. Значение по умолчанию - длина строки.


Описание

Символы в строке индексируются слева направо. Индекс первого символа 0, а индекс последнего символа строки, называемый StringName, это StringName.length - 1.

"canal".lastIndexOf("a")   // возвращает 3

"canal".lastIndexOf("a",2) // возвращает 1

"canal".lastIndexOf("a",0) // возвращает -1

"canal".lastIndexOf("x")   // возвращает -1

Метод lastIndexOf чувствителен к регистру. Например, следующее выражение вернёт -1:

"Blue Whale, Killer Whale".lastIndexOf("blue")

Примеры

Этот пример использует indexOf и lastIndexOf для локализации значений в строке "Brave new world."

var anyString="Brave new world"

// Отображает 8

document.write("<P>The index of the first w from the beginning is " +

   anyString.indexOf("w"))

// Отображает 10

document.write("<P>The index of the first w from the end is " +

   anyString.lastIndexOf("w"))

// Отображает 6

document.write("<P>The index of 'new' from the beginning is " +

   anyString.indexOf("new"))

// Отображает 6

document.write("<P>The index of 'new' from the end is " +

   anyString.lastIndexOf("new"))


См. также

, , .



Length


Беззнаковое 32-битное целое, специфицирующее количество элементов массива.

Свойство из

Реализовано вJavaScript 1.1, NES 2.0

JavaScript 1.3: length это беззнаковое 32-битное целое число со значением меньше 232.

Версия ECMA

ECMA-262


Описание

Значением свойства length является целое положительное число, меньшее, чем 2 в 32 степени (232).

Вы можете установить свойство length

для усечения массива в любой момент. Если Вы увеличиваете массив путём изменения его свойства length, реальное количество элементов не увеличивается; например, если Вы установите length

в 3, когда текущее значение 2, массив будет по прежнему содержать 2 элемента.


Примеры

В этом примере функция getChoice использует свойство length

для итерации по всем элементам массива musicType. musicType

это элемент select в форме musicForm.

function getChoice() {

   for (var i = 0; i < document.musicForm.musicType.length; i++) {

      if (document.musicForm.musicType.options[i].selected == true) {

         return document.musicForm.musicType.options[i].text

      }

   }

}

В этом примере массив statesUS

укорачивается до размера 50, если его текущий размер больше, чем 50.

if (statesUS.length > 50) {

   statesUS.length=50

}


Специфицирует количество аргументов, ожидаемых функцией.

Свойство из

Реализовано вJavaScript 1.1

Версия ECMAECMA-262

Описание

length является внешним относительно функции и указывает, сколько аргументов функция ожидает. По контрасту, arguments.length является локальным относительно функции и предоставляет количество аргументов, реально передаваемых функции.


Пример

См. пример для .


См. также

.




Длина строки.

Свойство из

Read-only\Только для Чтения

Реализовано вJavaScript 1.0, NES 2.0

Версия ECMAECMA-262


Описание

Для null-строки length будет 0.


Примеры

Этот пример выводит 8 в диалоговом окне Alert:

var x="Netscape"

alert("The String length is " + x.length)




Количество элементов Java-массиве, представленных объектом JavaArray.

Свойство из

Реализовано вJavaScript 1.1, NES 2.0


Описание

В отличие от Array.length, JavaArray.length

это свойство только для чтения. Вы не можете изменить значение свойства JavaArray.length, поскольку массивы Java имеют фиксированное количество элементов.


См. также

.



Link


Создаёт гипертекстовую ссылку HTML, которая запрашивает другой URL.

Метод из

Реализован вJavaScript 1.0, NES 2.0


Синтаксис

link(hrefAttribute)

Параметры

hrefAttribute

Любая строка, специфицирующая атрибут HREF тэга A; это должен быть верный URL (относительный или абсолютный).


Описание

Используйте метод link для создания программно гипертекстовой ссылки, затем вызовите методы write или writeln для отображения ссылки в документе. В серверном JavaScript используйте для отображения строки функцию write.

Ссылки, созданные методом link, становятся элементами массива ссылок объекта document. См. document.links.


Примеры


Этот пример отображает слово  "Netscape" как гипертекстовую ссылку, переводящую пользователя на домашнюю страницу Netscape:

var hotText="Netscape"

var URL="http://home.netscape.com"

document.write("Click to return to " + hotText.link(URL))

Вывод будет таким же, как и в нижеследующем HTML:

Click to return to <A HREF="http://home.netscape.com">Netscape</A>



Натуральный логарифм от 2, приблизительно


Натуральный логарифм от 2, приблизительно 0.693.
Свойство из Static, Read-only Реализовано вJavaScript 1.0, NES 2.0

Версия ECMAECMA-262

Пример


Эта функция возвращает натуральный логарифм от 2:

function getNatLog2() {

   return Math.LN2

}

Описание


Поскольку LN2 это static-свойство из Math, Вы всегда используете его так: Math.LN2, а не как свойство Math-объекта, созданного Вами.


Натуральный логарифм от 10, приблизительно


Натуральный логарифм от 10, приблизительно 2.302.
Свойство из Static, Только-для-Чтения

Реализовано вJavaScript 1.0, NES 2.0

Версия ECMAECMA-262

Пример


Эта функция возвращает натуральный логарифм от 10:

function getNatLog10() {

   return Math.LN10

}

Описание


Поскольку LN10 это static-свойство из Math, Вы всегда используете его так: Math.LN10, а не как свойство Math-объекта, созданного Вами.


Log


Возвращает натуральный логарифм (база E) числа.

Метод из

StaticРеализован в

JavaScript 1.0, NES 2.0Версия ECMA

ECMA-262


Синтаксис

log(x)

Параметр

x

Число.


Описание

Если number имеет отрицательное значение, return-значение будет всегда NaN.

Поскольку log это static-метод из Math, Вы всегда используете его так: Math.log(), а не как метод Math-объекта, созданного Вами.


Пример

Эта функция возвращает натуральный логарифм переменной x:

function getLog(x) {

   return Math.log(x)

}

Если вы передаёте в getLog значение 10, он возвращает 2.302585092994046; если Вы передаёте значение 0, от возвращает -Infinity; если передаёте -1, возвращает NaN, поскольку -1 находится вне диапазона.


См. также

, .



LOG2E


База 2, логарифм E (приблизительно 1.442).

Свойство из Static, Только-для-Чтения

Реализован вJavaScript 1.0, NES 2.0

Версия ECMAECMA-262


Пример

Эта функция возвращает логарифм Е с базой 2:

function getLog2e() {

   return Math.LOG2E
}

Описание

Поскольку LOG2E это static-свойство из Math, Вы всегда используете его так: Math.LOG2E, а не как свойство Math-объекта, созданного Вами.



LOG10E


База 10, логарифм E (приблизительно 0.434).

Свойство из Static, Read-only

Реализован вJavaScript 1.0, NES 2.0

Версия ECMAECMA-262


Пример

Эта функция возвращает логарифм Е с базой 10:

function getLog10e() {

   return Math.LOG10E

}


Описание

Поскольку LOG10E это static-свойство из Math, Вы всегда используете его так: Math.LOG10E, а не как свойство Math-объекта, созданного Вами.