Escape
Возвращает 16-ричное значение - кодировку аргумента из набора символов ISO Latin-1.
Функция ядра |
|
Реализована в | JavaScript 1.0, NES 2.0
|
Версия ECMA | ECMA-262-совместимая, исключая символы Unicode. |
Eval
Вычисляет строку кода JavaScript без ссылки на определённый объект.
Функция ядра |
|
Реализована в | JavaScript 1.0
|
Версия ECMA | ECMA-262 |
Свойства и функции верхнего уровня
В этой главе рассматриваются все свойства и функции JavaScript, не ассоциированные с какими-либо объектами. В спецификации ECMA эти свойства и функции называются свойствами и методами объекта global.
В следующей таблице собраны свойства верхнего уровня.
Таблица 2.1 Свойства верхнего уровня
Свойство
Описание
Infinity |
Числовое значение, представляющее бесконечность.
|
NaN |
Значение, представляющее Not-A-Number/Не-Число.
|
undefined |
Значение undefined. |
В следующей таблице собраны функции верхнего уровня.
Таблица 2.2 Функции верхнего уровня
Функция
Описание
escape |
Возвращает 16-ричное значение - кодировку аргумента из набора символов ISO Latin-1; используется для создания строк для добавления в URL.
|
eval |
Вычисляет строку кода JavaScript без ссылки на определённый объект.
|
isFinite |
Вычисляет аргумент с целью определить, является ли он конечным числом.
|
isNaN |
Вычисляет аргумент с целью определить, является ли он не-числом.
|
Number |
Конвертирует объект в число. |
parseFloat |
Разбирает строковой аргумент и возвращает число с плавающей точкой.
|
parseInt |
Разбирает строковой аргумент и возвращает целое число.
|
String |
Конвертирует объект в строку. |
taint |
Добавляет разрушение данных к элементу данных или скрипту.
|
unescape |
Возвращает ASCII-строку для специфицированного 16-ричного кодового значения.
|
untaint |
Убирает разрушение данных с элемента данных или скрипта. |
Infinity
Числовое значение, представляющее бесконечность.
Свойство ядра |
|
Реализовано в |
JavaScript 1.3 (В предыдущих версиях Infinity было определено только как свойство объекта Number).
|
Версия ECMA | ECMA-262 |
Isfinite
Вычисляет аргумент с целью определить, является ли он конечным числом.
Функция ядра |
|
Реализована в | JavaScript 1.3
|
Версия ECMA | ECMA-262 |
Isnan
Вычисляет аргумент с целью определить, является ли он не-числом.
Функция ядра |
|
Реализована в |
JavaScript 1.0: только Unix.
JavaScript 1.1, NES 2.0: все платформы.
|
Версия ECMA | ECMA-262 |
Nan
Значение, представляющее Not-A-Number/Не-Число.
Свойство ядра |
|
Реализовано в |
JavaScript 1.3 (В предыдущих версиях, NaN было определено только как свойство объекта Number).
|
Версия ECMA | ECMA-262 |
Number
Конвертирует специфицированный объект в число.
Функция ядра |
|
Реализована в | JavaScript 1.2, NES 3.0
|
Версия ECMA | ECMA-262 |
escape это функция верхнего уровня,
escape это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Используйте функции escape и unescape для кодирования и декодирования (добавления вручную значений свойств) Uniform Resource Locator (URL), Uniform Resource Identifier (URI) или строки URI-типа.
Функция escape кодирует специальные символы в специфицированной строке и возвращает новую строку. Она кодирует пробелы, знаки пунктуации и любой другой символ, не являющийся алфавитным или числовым ASCII-символом, за исключением следующих символов:
* @ - _ + . /
Unicode.
Функции 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 не поддерживаются.
eval это функция верхнего уровня,
eval это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Аргументом функции eval является строка. Если строка представляет выражение, eval вычисляет выражение. Если аргумент представляет собой один или более операторов JavaScript, eval выполняет эти операторы. Не вызывайте eval для вычисления арифметических выражений; JavaScript вычисляет арифметические выражения автоматически.
Если Вы конструируете арифметическое выражение как строку, Вы можете в дальнейшем использовать eval для его вычисления. Например, предположим, у Вас имеется переменная x. Вы можете отсрочить вычисление выражения, включающего x, присвоив строковое значение выражения, скажем, "3 * x + 2", переменной и вызвав eval в скрипте позднее.
Если аргументом 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")
Infinity это свойство верхнего уровня,
Infinity это свойство верхнего уровня, не ассоциированное с каким-либо объектом.
Начальным значением Infinity является Number.POSITIVE_INFINITY. Значение Infinity (положительная бесконечность) больше любого другого числа, включая себя самого. Это значение математически ведёт себя как бесконечность; например, что-либо, умноженное на Infinity, даёт Infinity, что-нибудь, делённое на Infinity даёт 0.
isFinite это функция верхнего уровня,
isFinite это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Можно использовать этот метод для того чтобы определить, является ли данное число конечным. Метод isFinite проверяет число-аргумент. Если аргумент равен NaN, положительной или отрицательной бесконечности, метод возвращает false, иначе возвращает true.
isNaN это функция верхнего уровня,
isNaN это функция верхнего уровня, не ассоциированная с каким-либо объектом.
На платформах, поддерживающих NaN, функции parseFloat и parseInt возвращают NaN, если вычисляют значение, не являющееся числом. isNaN возвращает true, если передано NaN, и false - в ином случае.
NaN это свойство верхнего уровня,
NaN это свойство верхнего уровня, не ассоциированное с каким-либо объектом.
Начальным значением NaN является NaN.
NaN всегда не равно любому другому числу, включая само NaN; Вы не можете проверить на значение not-a-number путём сравнения с Number.NaN. Вместо этого используйте функцию isNaN.
Некоторые методы JavaScript (такие как конструктор Number, parseFloat и parseInt) возвращают NaN, если значение, специфицированное в параметре, не является числом.
Вы можете использовать свойство NaN для указания на ошибочное условие функции, которая должна возвращать верное число.
Number это функция верхнего уровня,
Number это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Если объект является Date-объектом, Number возвращает значение в миллисекундах, отмеренное от даты 1 января 1970 года UTC (GMT), положительное - после этой даты, негативное - до.
Если obj это строка, которая не содержит правильно оформленного числового литерала, Number возвращает NaN.
parseFloat это функция верхнего уровня,
parseFloat это функция верхнего уровня, не ассоциированная с каким-либо объектом.
parseFloat разбирает свой аргумент, строку, и возвращает число с плавающей точкой. Если он обнаруживает символ, отличный от знака (+ или -), цифры (0-9) и десятичной точки, или экспоненты, он возвращает значение до этой точки и игнорирует этот и все последующие символы. Ведущие и ведомые пробелы разрешаются.
Если первый символ не может быть конвертирован в число, parseFloat возвращает NaN.
Для арифметических целей значение NaN является не-числом для любой основы/radix. Вы можете вызвать функцию isNaN, чтобы определить, является ли результат работы parseFloat значением NaN. Если NaN передаётся арифметической операции, результат операции также будет NaN.
parseInt это функция верхнего уровня,
parseInt это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Функция parseInt разбирает свой первый аргумент, строку, и пытается возвратить целое число - специфицированный radix (основание). Например, radix 10 указывает на конвертацию в десятеричное число, 8 - в восьмеричное, 16 - в шестнадцатеричное, и т.д. Для оснований больше 10, буквы латинского алфавита обозначают цифры больше 9. Например, для 16-ричных чисел (основание 16) используются буквы от A до F включительно.
Если 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.
String это функция верхнего уровня,
String это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Метод String конвертирует значение любого объекта в строку; он возвращает такое же значение, что и метод toString отдельного объекта.
Если объект является Date-объектом, String возвращает более читабельное строковое представление даты. Формат такой: Thu Aug 18 04:37:43 Pacific Daylight Time 1983.
taint это функция верхнего уровня,
taint это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Tainting/разрушение/порча данных предотвращает передачу информации, которая должна быть закрытой и секретной, такой как структура директорий или история пользовательской сессии. JavaScript не может передать разрушенные значения на сервер без наличия разрешения для конечного пользователя.
Используйте taint для маркировки данных, которые иначе остаются неразрушенными.
В некоторых случаях поток управления, а не поток данных, работает с разрушенными данными. Тогда taint добавляется к окну, содержащему скрипт. Вы можете добавить taint к окну скрипта, вызвав taint без аргументов.
taint не модифицирует аргументы; она возвращает маркированную копию значения или, для объектов, немаркированную ссылку на это значение.
undefined это свойство верхнего уровня,
undefined это свойство верхнего уровня, не ассоциированное с каким-либо объектом.
Переменная, которой не присвоено значение, имеет тип undefined. Метод или оператор также возвращает undefined, если вычисляемая переменная не имеет присвоенного значения.
Можно использовать undefined для того чтобы определить, имеет ли переменная значение.
В этом коде переменная x не определена, и оператор if вычисляется в true.
var x
if(x == undefined) {
// здесь выполняются операторы
}
undefined является также примитивным значением.
unescape это функция верхнего уровня,
unescape это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Строка, возвращаемая функцией unescape, является серией символов из набора ISO-Latin-1.
Методы escape и unescape не используют Unicode, как специфицировано ECMA. Дополнительно см. описание "Unicode".
untaint это функция верхнего уровня,
untaint это функция верхнего уровня, не ассоциированная с каким-либо объектом.
Разрушение данных/Tainting предотвращает передачу другими скриптами частной или секретной информации, такой как структура директорий или история пользовательской сессии. JavaScript не может передать разрушенные значения на сервер без наличия разрешения для конечного пользователя.
Используйте untaint для удаления разрушения с тех данных, которые должны передаваться другими скриптами на другие серверы.
Скрипт может untaint только те данные, которые были созданы в этом скрипте (то есть, только те данные, которые имеют taint-код скрипта или имеют тождественный (null) taint-код). Если Вы используете untaint с элементом данных скрипта другого сервера (или с данными, которые Вы не можете untaint), untaint возвращает данные без изменений или ошибку.
В некоторых случаях поток управления, а не поток данных, работает с разрушенными данными. Тогда taint добавляется к окну, содержащему скрипт. Вы можете удалить taint из окна скрипта, вызвав untaint без аргументов, если окно содержит taint, но только для текущего окна.
untaint не модифицирует свой аргумент; она возвращает немаркированную копию значения или, для объектов, немаркированную ссылку на это значение.
Строка из набора символов
string |
Строка из набора символов ISO-Latin-1.
|
представляющая выражение, оператор или последовательность
string |
Строка, представляющая выражение, оператор или последовательность операторов JavaScript. Выражение может содержать переменные и свойства существующих объектов.
|
Вычисляемое число
number |
Вычисляемое число.
|
Тестируемое значение
testValue |
Тестируемое значение.
|
Объект
представляющая значение, которое Вы хотите
string |
Строка, представляющая значение, которое Вы хотите разобрать/parse.
|
Объект
функция или объект для разрушения.
dataElementName |
Свойство, переменная, функция или объект для разрушения. При отсутствии этого параметра, taint добавляется к самому скрипту.
|
где xx это
string |
Строка, содержащая символы в формате "%xx", где xx это 16-ричное число.
|
С этого свойства, переменной, функции
dataElementName |
С этого свойства, переменной, функции или объекта разрушение данных убирается. При отсутствии этого параметра, taint убирается с самого скрипта.
|
представляющая значение, которое нужно
string |
Строка, представляющая значение, которое нужно разобрать. |
radix |
Целое число, представляющее основание/radix return-значения.
|
Parsefloat
Разбирает строковой аргумент и возвращает число с плавающей точкой.
Функция ядра |
|
Реализована в |
JavaScript 1.0: если первый символ строки, специфицированной в parseFloat(string), не может быть конвертирован в число, возвращается NaN на Solaris и Irix и 0 - на всех других платформах.
JavaScript 1.1, NES 2.0: возвращается NaN на всех платформах, если первый символ строки, специфицированной в parseFloat(string), не может быть конвертирован в число.
|
Версия ECMA | ECMA-262 |
Parseint
Разбирает строковой аргумент и возвращает целое число со специфицированным radix или базой.
Функция ядра |
|
Реализована в |
JavaScript 1.0: если первый символ строки, специфицированной в parseInt(string), не может быть конвертирован в число, возвращается NaN на Solaris и Irix и 0 - на всех других платформах.
JavaScript 1.1, LiveWire 2.0: возвращается NaN на всех платформах, если первый символ строки, специфицированной в parseInt(string), не может быть конвертирован в число.
|
Версия ECMA | ECMA-262 |
Можно проверить ввод клиента, чтобы
Можно проверить ввод клиента, чтобы определить, введено ли конечное число.
if(isFinite(ClientInput) == true)
{
/* некоторые действия */
}
Этот пример вычисляет floatValue для
Этот пример вычисляет floatValue для определения, является ли оно числом, а затем вызывает соответствующую процедуру:
floatValue=parseFloat(toFloat)if (isNaN(floatValue)) {
notFloat()
} else {
isFloat()
}
Выводится диалоговое окно, содержащее
Date-объект конвертируется в числовое значение:
d = new Date ("December 17, 1995 03:24:00")
alert (Number(d))
Выводится диалоговое окно, содержащее "819199440000."
Будет выведен диалог, содержащий
В этом примере Date-объект конвертируется в читаемую строку:
D = new Date (430054663215)
alert (String(D))
Будет выведен диалог, содержащий "Thu Aug 18 04:37:43 GMT-0700 (Pacific Daylight Time) 1983."
к свойству, поэтому скрипт не
Следующий оператор добавляет taint/разрушение данных к свойству, поэтому скрипт не может отправить это свойство серверу, не имея разрешения для конечного пользователя/end user's permission:
taintedStatus=taint(window.defaultStatus)
// taintedStatus теперь не может быть отправлена в URL или form post без
// end user's permission
taint из свойства, поэтому скрипт
Следующий оператор удаляет разрушение данных/ taint из свойства, поэтому скрипт может быть выслан другому серверу:
untaintedStatus=untaint(window.defaultStatus)
// untaintedStatus может теперь быть выслана в URL или form post другими скриптами
Этот пример возвращает
Пример 1. Этот пример возвращает "%26":
escape("&") // возвращает "%26"
Пример 2. Следующий оператор возвращает строку кодированных символов для пробелов, запятых и апострофов.
// возвращает "The_rain.%20In%20Spain%2C%20Ma%92am"
escape("The_rain. In Spain, Ma'am")
В серверном JavaScript можно отобразить
Следующие примеры отображают вывод с помощью document.write. В серверном JavaScript можно отобразить тот же самый вывод через вызов функции write вместо использования document.write.
Пример 1. В этом коде оба оператора, содержащие eval, возвращают 42. Первый вычисляет строку "x + y + 1"; второй вычисляет строку "42".
var x = 2
var y = 39
var z = "42"
eval("x + y + 1") // возвращает 42
eval(z) // возвращает 42
Пример 2. В следующем примере функция getFieldName(n) возвращает имя специфицированного элемента формы как строку. Первый оператор присваивает строковое значение третьего элемента формы переменной field. Второй оператор использует eval для отображения значения элемента формы.
var field = getFieldName(3)
document.write("The field named ", field, " has value of ",
eval(field + ".value"))
Пример 3. Здесь eval используется для вычисления строки str. Эта строка состоит из операторов JavaScript, которые открывают диалоговое окно Alert и присваивают переменной z значение 42, если x равен пяти, и присваивают переменной z 0 в ином случае. Если второй оператор выполняется, eval вызывает выполнение этих операторов, а также вычисляет набор операторов и возвращает значение, присвоенное переменной z.
var str = "if (x == 5) {alert('z is 42'); z = 42;} else z = 0; "
document.write("<P>z is ", eval(str))
Пример 4. В следующем примере функция setValue использует eval для присвоения значения переменной newValue текстовому полю textObject:
function setValue (textObject, newValue) {
eval ("document.forms[0]." + textObject + ".value") = newValue
}
Пример 5. В этом примере создаётся breed как свойство объекта myDog, а также как переменная. Первый оператор write использует eval('breed') без специфицирования объекта; строка "breed" вычисляется безотносительно какого-либо объекта, а метод write выводит "Shepherd", что является значением переменной breed. Второй оператор write использует myDog.eval('breed'), что специфицирует объект myDog; строка "breed" вычисляется с учётом объекта myDog, а метод write выводит "Lab", что является значением свойства breed объекта myDog.
function Dog(name,breed,color) {
this.name=name
this.breed=breed
this.color=color
}
myDog = new Dog("Gabby")
myDog.breed="Lab"
var breed='Shepherd'
document.write("<P>" + eval('breed'))
document.write("<BR>" + myDog.eval('breed'))
Все следующие строки возвращают
Все следующие строки возвращают 3.14:
parseFloat("3.14")
parseFloat("314e-2")
parseFloat("0.0314E+2")
var x = "3.14"
parseFloat(x)
Следующий пример возвращает NaN:
parseFloat("FF2")
Хотя специфицирован различный radix, все
Все следующие строки возвращают 15:
parseInt("F", 16)
parseInt("17", 8)
parseInt("15", 10)
parseInt(15.99, 10)
parseInt("FXX123", 16)
parseInt("1111", 2)
parseInt("15*3", 10)
Все следующие строки возвращают NaN:
parseInt("Hello", 8)
parseInt("0x7", 10)
parseInt("FFF", 10)
Хотя специфицирован различный radix, все следующие строки возвращают 17, поскольку string ввода начинается с "0x".
parseInt("0x11", 16)
parseInt("0x11", 0)
parseInt("0x11")
Следующий пример возвращает
Следующий пример возвращает "&":
unescape("%26")
Следующий пример возвращает "!#":
unescape("%21%23")
String
Конвертирует специфицированный объект в строку.
Функция ядра |
|
Реализована в | JavaScript 1.2, NES 3.0
|
Версия ECMA | ECMA-262 |
Taint
Добавляет разрушение данных к элементу данных или скрипту.
Клиентская функция |
|
Реализована в |
JavaScript 1.1 JavaScript 1.2: удалена. |
Undefined
Значение undefined.
Свойство ядра |
|
Реализовано в | JavaScript 1.3
|
Версия ECMA | ECMA-262 |
Unescape
Возвращает ASCII-строку для специфицированного 16-ричного кодового значения.
Функция ядра |
|
Реализована в | JavaScript 1.0, NES 1.0
|
Версия ECMA | ECMA-262-совместимая, за исключением символов Unicode. |
Untaint
Убирает разрушение данных с элемента данных или скрипта.
Клиентская функция |
|
Реализована в | JavaScript 1.1
JavaScript 1.2: удалена. |