Функции верхнего уровня  

См. пункты: Infinity, NaN, undefined, Boolean, decodeURI(), decodeURIComponent(), encodeURI(), encodeURIComponent(), escape(), eval(), isFinite(), isNaN(), Number, Object, parseFloat(), parseInt(), ScriptEngine(), ScriptEngineBuildVersion(), ScriptEngineMajorVersion(), ScriptEngineMinorVersion(), String(), taint(), toString(), unescape(), untaint(), unwatch() и watch().


Независимые типы данных:


Infinity JavaScript 1.3 (В предыдущих версиях Infinity было определено только как свойство объекта Number).

 

Числовое значение, представляющее бесконечность. Начальным значением Infinity является Number.POSITIVE_INFINITY. Значение Infinity (положительная бесконечность) больше, чем любые другие числа, в том числе и она сама. Это значение математически ведёт себя как Бесконечность; например, что-либо, умноженное на Бесконечность, является Бесконечностью, и что-либо, делённое на бесконечность, является 0.


NaN JavaScript 1.3 (В предыдущих версиях NaN было определено только как свойство объекта Number).

 

Значение, представляющее Not-A-Number/Не-Число. Начальным значением NaN является NaN.

NaN всегда не равно любому другому числу, включая само NaN; Вы не можете проверить на наличие значения not-a-number, сравнивая Number.NaN. Вместо этого используйте функцию isNaN.

Некоторые методы JavaScript (такие как конструктор Number, parseFloat и parseInt) возвращают NaN, если значением специфицированного параметра не является число.

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


undefined JavaScript 1.3, ECMA-262

 

Значение "undefined" (неопределённое).

Переменная , которой не присвоено никакого значения, имеет тип undefined. Метод или оператор также возвращают undefined, если вычисляемая переменная не имеет присвоенного значения.

Вы можете использовать undefined, чтобы определить, присвоено ли значение переменной.
В этом коде переменная x не определена, и оператор if вычисляется в true.

var x
if(x == undefined) {
// эти операторы выполняются
}


Функции:


Boolean() JavaScript 1.5, NES 6.0, ECMA-262 Edition 3.

Boolean(объект)

Метод Boolean преобразует аргумент в логическое значение

 
Возвращаемое значение
Булево значение
 
Параметры
объект Любой объект JavaScript

decodeURI() NN n/a, IE 5.5, NES 6.0, ECMA-262 Edition 3.

decodeURI(encodedURI)

Декодирует Uniform Resource Identifier (URI), созданный до этого функцией encodeURI или аналогичным способом. Заменяет каждую escape-последовательность кодированного URI символом, который эта последовательность представляет. Не декодирует escape-последовательности, которые не могут быть созданы функцией encodeURI.

 
Возвращаемое значение
Строка
 
Параметры
encodedUri Полный кодированный Uniform Resource Identifier.

decodeURIComponent() NN n/a, IE 5.5, NES 6.0, ECMA-262 Edition 3.

decodeURIComponent(encodedURI)

Декодирует компонент Uniform Resource Identifier'а (URI), созданный ранее функцией encodeURIComponent или аналогичным способом. Заменяет каждую escape-последовательность кодированного компонента URI символом, который эта последовательность представляет.

 
Возвращаемое значение
Строка
 
Параметры
encodedUri Полный кодированный Uniform Resource Identifier.

encodeURI() NN n/a, IE 5.5, NES 6.0, ECMA-262 Edition 3.

encodeURI(uri)

Кодирует Uniform Resource Identifier (URI), замещая каждый экземпляр определённого символа одной, двумя или тремя escape-последовательностями, представляющими кодировку данного символа в UTF-8. Предполагает, что URI является полным URI, поэтому не кодирует зарезервированные символы, имеющие специальное значение в URI. encodeURI замещает все символы соответствующими escape-последовательностями UTF-8, за исключением следующих символов:

зарезервированные символы , / ? : @ & = + $ ,
незаменяемые символы алфавитные, десятеричные цифры, - _ . ! ~ * ' ( )
знак score #
 
Возвращаемое значение
Строка
 
Параметры
uri Полный Uniform Resource Identifier.

encodeURIComponent() NN n/a, IE 5.5, NES 6.0, ECMA-262 Edition 3.

encodeURI(uri)

Кодирует компонент Uniform Resource Identifier'а (URI), замещая каждый экземпляр определённого символа одной, двумя или тремя escape-последовательностями, представляющими кодировку данного символа в UTF-8. Принимает, что URI - это компонент URI, а не полный URI, поэтому не рассматривает зарезервированные символы как имеющие специальное значение и кодирует их. См. в encodeURI список зарезервированных символов.

encodeURIComponent замещает все символы соответствующими escape-последовательностями UTF-8, за исключением следующих символов:

незаменяемые символы алфавитные, десятеричные цифры, - _ . ! ~ * ' ( )
знак score #
 
Возвращаемое значение
Строка
 
Параметры
uri Компонент Uniform Resource Identifier'а.

escape() NN 2  IE J1  ECMA 1
escape(string)  

Возвращается URL-КОДИРОВАННАЯ версия строки, прошедшей как параметр для функции. Кодирование URL преобразовывает неалфавитно-цифровые символы к шестнадцатеричным значениям (типа %20 для пробела). URL-КОДИРОВАННЫЕ строки обычно не кодируют символ плюс , потому что этот символ используется, чтобы отделить компоненты строк для поиска. Если Вам нужно кодировать символ плюс тоже, Navigator 4 предлагает второй параметр (цифра 1) чтобы включить выключатель для метода. Функции escape и unescape неправильно работают с не- ASCII символами.

Эта функция не должна использоваться для стандартной кодировки строк, содержащих URI. Вместо нее следует использовать методы encodeURI и encodeURIComponent.

Обратное преобразование строки производится методом unescape

Функции escape и unescape не используют Unicode, как указано в спецификации ECMA. Вместо этого они используют указания Internet Engineering Task Force (IETF) для заменяющих/escaping символов. В URI символы используют US-ASCII-символы (набор символов ISO-Latin-1). URI это последовательность символов из базового латинского алфавита, цифры и несколько специальных символов (например, / и @). Еscape-последовательности не поддерживают как Unicode-значения \uXXXX или %uXXXX, как специфицировано ECMA, но поддерживают %XX, где XX это 16-ричное число из двух цифр (например, %7E). В URI представлены восьмеричными числами, как 8-битные байты. Чтобы escape и unescape могли работать с поддерживаемыми Web-сервером URL и URI, JavaScript не использует Unicode для этих функций.

  • escape возвращает 16-ричную кодировку специфицированной строки из набора символов ISO-Latin-1.
  • unescape возвращает ASCII-строку, последовательность символов из набора ISO-Latin-1.

Unicode-специфичные escape-последовательности %uXXXX не поддерживаются.

 
Возвращаемое значение
Строка
 
Параметры
string Любое строковое значение.

eval() NN 2  IE J1  ECMA 1
eval(string)  

Возвращает ссылку на объект, записанный как строка в параметре функции. Например, если форма имеет последовательность текстовых полей, названных entry1, entry2, entry3, и так далее, Вы можете использовать цикл for, чтобы циклически перебрать все элементы по именам, если позволите функции eval() преобразовать строковое представление имен в ссылки на объекты:

for (var i = 1; i <=5; i++) { oneField = eval("document.forms[0].entry" + i) oneValue = oneField.value ... }

Если строка представляет собой выражение, eval вычисляет это выражение. Если аргументом является один или более операторов JavaScript, eval выполняет эти операторы. Не вызывайте eval для вычисления арифметических выражений; JavaScript вычисляет арифметические выражения автоматически.

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

eval(new String("2+2")) // возвращает String-объект, содержащий "2+2"
eval("2+2") // возвращает 4

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

var x = 2
var y = 4
var myEval = eval
myEval("x + y")

 
Возвращаемое значение
Ссылка на объект.
 
Параметры
string Любое строковое представление ссылки на объект.

isFinite() NN 4  IE J3  ECMA 1
isFinite(expression)  

Возвращает Булево значение true если номер, прошедший как параметр, находится в пределах диапазона Number.MIN_VALUE и Number.MAX_VALUE (включительно). Строковые значения заставляют функцию возвращать false.

 
Возвращаемое значение
Булево значение
 
Параметры
expression Любое выражение JavaScript.

isNaN() NN 2  IE J1  ECMA 1

Возвращает Булево значение true, если параметр - нечисловое выражение.

 
Возвращаемое значение
Boolean.
 
Параметры
expression Любое выражение JavaScript.

Number() NN 2  IE J1  ECMA 1
Number(obj)  

Конвертирует специфицированный объект в число.

 
Возвращаемое значение
Boolean.
 
Параметры
obj Объект.

Object() NN 2  IE J1  ECMA 1

Метод Object преобразует аргумент в объектное значение

 
Возвращаемое значение
Объект
 
Параметры
Любое значение

parseInt() NN 2  IE J1  ECMA 1
parseInt(string[, radix])  

Возвращает целочисленное значение цифр (как тип данных integer по основанию 10) в прошедшей как параметр строке (если не указан дополнительный параметр). Строковое значение должно начинаться, по крайней мере, с цифры, иначе результат - NaN. Если строки начинаются с чисел, но дальше записаны символами, то только начальные литералы преобразовываются в числа. Поэтому Вы можете использовать выражение:

parseInt(navigator.appVersion)

для получения версии в виде целого номера и длинной строки после него.

Дополнительный параметр "основания системы счисления" позволяет Вам определять систему счисления числа, которое является входным значением функции. Строка номера, которая начинается с нуля, обычно обрабатывается как восьмеричное число, которое дает Вам неправильный ответ. Это - хорошая идея использовать значение radix 10, если все ваши числа - по основанию 10.

Если parseInt обнаруживает символ, который не является числом для специфицированного radix, он игнорирует это число и все последующие символы и возвращает целочисленное значение, разобранное до этой точки. parseInt усекает числа до целочисленных значений. Ведущие и ведомые пробелы допускаются. Если radix не специфицирован или специфицирован как 0, JavaScript принимает следующее:

  • Если string ввода начинается с "0x", radix равен 16 (16-ричное основание).
  • Если string ввода начинается с "0", radix восьмеричный.
  • Если string ввода начинается с любого другого значения, radix равен 10 (10-рчное основание).

Если первый символ не может быть конвертирован в число, parseInt возвращает NaN. Для арифметических целей значение NaN является не-числом при любом radix. Вы можете вызвать затем функцию isNaN, чтобы определить, является ли NaN результатом работы parseInt. Если NaN передаётся арифметической операции, результат операции также будет NaN.

 
Возвращаемое значение
Целое число по основанию 10.
 
Параметры
string Любая строка, которая начинается с одной или более цифр.
radix Целое число, представляющее собой основание системы счисления номера, прошедшего как строковый параметр (например, 2, 10, 16).

parseFloat() NN 2  IE J1  ECMA 1
parseFloat(string)  

Возвращает число цифр (или целое, или с плавающей запятой) в прошедшей как параметр строке. Строковое значение должно начинаться, по крайней мере, с цифры, иначе результат - NaN. Если строки начинаются с чисел, но дальше записаны символами, то только начальные литералы преобразовываются в числа. Поэтому Вы можете использовать выражение:

parseFloat(navigator.appVersion)

для получения версии в законченном виде (например, 4.03), которое ведет длинную строку

Если преобразованное значение не имеет никаких значений мантиссы, возвращенное значение - Целое число. Значения с плавающей точкой возвращаются только тогда, когда мантисса не равна нулю.

 
Возвращаемое значение
Число.
 
Параметры
string Любая строка, которая начинается с одной или более цифр.

ScriptEngine(), ScriptEngineBuildVersion(), ScriptEngineMajorVersion(), ScriptEngineMinorVersion() NN n/a  IE J2  ECMA n/a

Эти функции Internet Explorer-only показывают информацию о механизме выполнения сценария (JScript, VBScript, или VBA), который в настоящее время в запущен (выполняющий инструкции, вызывающий функции), и какая версия этого механизма установлена. Для JScript version обращается к версии JScript.dll файла, установленного среди файлов браузера. Мajor version - часть номера версии налево от десятичной точки версии; minor version - часть направо от десятичной точки. Более градуированный чем этот - внутренний номер компоновки, который Microsoft использует, чтобы следить за релизами.

 
Возвращаемое значение
ScriptEngine() возвращает как строку одно из следующих имен: JScript | VBA | VBScript. Все остальные функции возвращают целочисленные значения.
 
Параметры
None.

String() (с JavaScript1.2) JavaScript 1.2, NES 3.0, ECMA-262
String(obj)  

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

Если объект является Date-объектом, String возвращает более читабельное строковое представление даты. Формат такой: Thu Aug 18 04:37:43 Pacific Daylight Time 1983.

Пример

D = new Date (430054663215)
alert (String(D))

Будет выведен диалог, содержащий "Thu Aug 18 04:37:43 GMT-0700 (Pacific Daylight Time) 1983."

 
Возвращаемое значение
Строка.
 
Параметры
obj Объект.

toString() NN 3  IE J3  ECMA n/a
toString(radix)  

Возвращает строковую версию номера в системе счисления, указанном параметром radix (в отличие от одноимённого метода). Этот вариант функции toString() позволяет Вам преобразовть системы счисления. Например, следующая последовательность преобразовывает основание 10 к 16 и возвращает строку:

var a = 32 var b = a.toString(16)

После того, как эти инструкции выполняются, значение b = "20".

 
Возвращаемое значение
Строка.
 
Параметры
radix Целое число, представляющее собой основание системы счисления (например, 2, 10, 16).

taint() JavaScript 1.1, удалена в JavaScript 1.2
taint([dataElementName])  

Добавляет разрушение данных к элементу данных или скрипту. Tainting данных предотвращает передачу информации, которая должна быть закрытой и секретной, такой как структура директорий или история пользовательской сессии. JavaScript не может передать разрушенные значения на сервер без наличия разрешения для конечного пользователя.

Используйте taint для маркировки данных, которые иначе остаются неразрушенными.

В некоторых случаях поток управления, а не поток данных, работает с разрушенными данными. Тогда taint добавляется к окну, содержащему скрипт. Вы можете добавить taint к окну скрипта, вызвав taint без аргументов.

taint не модифицирует аргументы; она возвращает маркированную копию значения или, для объектов, немаркированную ссылку на это значение.

 
Возвращаемое значение
Нет
 
Параметры
dataElementName Свойство, переменная, функция или объект для разрушения. При отсутствии этого параметра, taint добавляется к самому скрипту.

unescape() NN 2  IE J1  ECMA 1
unescape(string)  

Возвращает декодированную версию URL-КОДИРОВАННОЙ строки, прошедший как параметр функции. Кодирование URL преобразовывает неалфавитно-цифровые символы в шестнадцатеричные значения (типа %20 для пробела). Функции escape и unescape неправильно работают с не- ASCII символами.

Функции escape и unescape не используют Unicode, как указано в спецификации ECMA. Вместо этого они используют указания Internet Engineering Task Force (IETF) для заменяющих/escaping символов. В URI символы используют US-ASCII-символы (набор символов ISO-Latin-1). URI это последовательность символов из базового латинского алфавита, цифры и несколько специальных символов (например, / и @). Еscape-последовательности не поддерживают как Unicode-значения \uXXXX или %uXXXX, как специфицировано ECMA, но поддерживают %XX, где XX это 16-ричное число из двух цифр (например, %7E). В URI представлены восьмеричными числами, как 8-битные байты. Чтобы escape и unescape могли работать с поддерживаемыми Web-сервером URL и URI, JavaScript не использует Unicode для этих функций.

  • escape возвращает 16-ричную кодировку специфицированной строки из набора символов ISO-Latin-1.
  • unescape возвращает ASCII-строку, последовательность символов из набора ISO-Latin-1.

Unicode-специфичные escape-последовательности %uXXXX не поддерживаются.

 
Возвращаемое значение
Строка
 
Параметры
string Любое УРЛ-КОДИРОВАННОЕ строковое значение.

untaint() JavaScript 1.1, удалена в JavaScript 1.2
untaint([dataElementName])  

Разрушение данных/Tainting предотвращает передачу другими скриптами частной или секретной информации, такой как структура директорий или история пользовательской сессии. JavaScript не может передать разрушенные значения на сервер без наличия разрешения для конечного пользователя.

Используйте untaint для удаления разрушения с тех данных, которые должны передаваться другими скриптами на другие серверы.

Скрипт может untaint только те данные, которые были созданы в этом скрипте (то есть, только те данные, которые имеют taint-код скрипта или имеют тождественный (null) taint-код). Если Вы используете untaint с элементом данных скрипта другого сервера (или с данными, которые Вы не можете untaint), untaint возвращает данные без изменений или ошибку.

В некоторых случаях поток управления, а не поток данных, работает с разрушенными данными. Тогда taint добавляется к окну, содержащему скрипт. Вы можете удалить taint из окна скрипта, вызвав untaint без аргументов, если окно содержит taint, но только для текущего окна.

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

 
Возвращаемое значение
Нет
 
Параметры
dataElementName С этого свойства, переменной, функции или объекта разрушение данных убирается. При отсутствии этого параметра, taint убирается с самого скрипта.

unwatch(), watch() NN 4  IE n/a  ECMA n/a
unwatch(property, funcHandler)  
watch(property, funcHandler)  

Эти специфические для Navigatorа функции используются прежде всего отладчиками JavaScript . Когда инструкция вызывает для объекта функцию watch(), параметры включают свойство, значение которго должно наблюдаться и ссылку на функцию, которая будет вызвана всякий раз, когда значение свойства изменено оператором присваивания. Чтобы выключить операцию watch, вызовите функцию unwatch()..

 
Возвращаемое значение
Ничего
 
Параметры
property Свойство объекта, за которым нужно наблюдать.
funcHandler Имя функции (никаких круглых скобок), вызываемой всякий раз, когда изменяются значения наблюдаемого свойства.


HIVE: All information for read only. Please respect copyright!
Hosted by hive КГБ: Киевская городская библиотека