Встроенные функции и константы
Значение положительной бесконечности. Результат 1 / 0 .
Значение Not a Number для вещественной арифметики.
argumentsПеременная-массив содержит аргументы, переданные в текущую функцию. См. справочник MDN.
atob(base64string)Декодирует строку base64string из кодировки Base 64 в строку с двоичными данными. Параметр и результат имеют тип String .
btoa(binaryData)Кодирует строку с двоичными данными binaryData в кодировку Base 64. Параметр и результат имеют тип String .
changeInterval(id, time)Изменяет период интервальной функции.
Изменения вступают в силу с очередным вызовом функции-обработчика — таким образом изменения не моментальны.
clearInterval([id])Останавливает работу интервальной функции. Параметр id — идентификатор, который вернул setInterval .
Если id опущен, будут остановлены все интервальные и отложенные функции.
clearTimeout([id])Отменяет запуск отложенной функции. Параметр id — идентификатор, который вернула setTimeout .
Если id опущен, будут остановлены все отложенные и интервальные функции.
eval(code)Исполняет код JavaScript, переданный в виде строки code .
Возвращает результат последнего выполненного выражения из code .
globalСсылка на объект глобальной области видимости.
isNaN(x)Возвращает true , если x имеет значение NaN .
parseFloat(string)Преобразует строку string в вещественное число. Возвращает NaN , если строка по содержимому не соответствует числу.
parseInt(string[, radix])Преобразует строку string в целое число.
Если задан radix определяет основание числа. По умолчанию используется десятичная система счисления.
Возвращает NaN , если строка по содержимому не соответствует числу.
require(moduleName)Загружает модуль (библиотеку) moduleName и возвращает объект, экспортируемый этим модулем.
Подробности о библиотеках приведены в статье об особенностях Iskra JS, а примеры использования функции рассмотрены в описаниях конкретных библиотек.
setInterval(callback, timeout[, args, …])Заставляет систему вызывать функцию callback или код переданный в виде строки каждые timeout миллисекунд.
Вы можете передать один или несколько параметров, которые будут переданы как есть при вызове callback .
setInterval возвращает число-идентификатор интервальной функции. Используйте его в качестве параметра clearInterval , чтобы остановить процесс.
Если был разрешён режим глубокого сна (setDeepSleep), а timeout более 5000 мс, платформа может проспать время вызова на величину до 1 секунды. Это связано с тем, что необходимость пробуждения от глубокого сна платформа определяет раз в секунду.
setTimeout(callback, timeout[, args, …])Заставляет систему вызывать функцию callback или код переданный в виде строки через timeout миллисекунд.
Вы можете передать один или несколько параметров, которые будут переданы как есть при вызове callback .
setTimeout возвращает число-идентификатор отложенной функции. Используйте его в качестве параметра clearTimeout , чтобы отменить запланированный вызов.
Если был разрешён режим глубокого сна ( setDeepSleep ), а timeout более 5000 мс, платформа может проспать время вызова на величину до 1 секунды. Это связано с тем, что необходимость пробуждения от глубокого сна платформа определяет раз в секунду.
Объекты-пины
Функциям и методам, которые принимают пины в качестве параметров, передают встроенные объекты-пины. Среди них есть синонимы. Используйте то обозначение, которое более уместно в конкретном контексте.
Все перечисленные объекты являются экземплярами класса Pin, поэтому помимо передачи их в функции, можно вызывать их собственные методы.
Функции работы с пинами
analogRead(pin)Считывает значение аналогового сигнала на пине pin и возвращает результат в виде числа в диапазоне [0.0; 1.0].
Пин должен поддерживать чтение аналоговых сигналов. См. функции пинов в документации на свою плату.
Если перед вызовом не вызывалась функция pinMode , пин будет автоматически переведён в режим 'analog' .
analogWrite(pin, value[, opts])Выдаёт аналоговый сигнал на пине pin . Используется аппаратный ШИМ или ЦАП, если они доступны на пине. См. функции пинов в документации на свою плату.
В случае ШИМ value задаёт скважность, в случае ЦАП — величину напряжения. В любом случае ожидается значение в диапазоне [0.0; 1.0].
В качестве необязательного параметра opts принимается объект с полями:
Если перед вызовом функции не вызывалась pinMode , пин будет автоматически переведён в режим 'output' .
clearWatch([id])Останавливает наблюдение за пином. Параметр id — идентификатор, который вернула setWatch .
Если id опущен, будут остановлены все наблюдения за пинами.
digitalPulse(pin, value, time)Генерирует импульс на пине pin длительностью time миллисекунд. value задаёт значение пульса: 1 — высокий сигнал, 0 — низкий.
Для точности функция использует аппаратный таймер и не блокирует исполнение программы, т.е. возвращается до того, как закончится импульс. Передайте 0 в качестве time , чтобы дождаться окончания предыдущего импульса.
В качестве time можно передать массив. В этом случае будет выдана серия импульсов с противоположными значениями длительностью, определяемой значением элементов массива, начиная с value .
Используйте функцию для коротких и очень точных импульсов. Для работы с периодами свыше нескольких миллисекунд используйте setTimeout .
Если перед вызовом не вызывалась функция pinMode , пин будет автоматически переведён в режим 'output' .
digitalRead(pin)Считывает цифровой сигнал с пина pin . Возвращает 1 , если на пине — логическая единица и 0 , если на пине — логический ноль.
В качестве pin можно передать массив пинов. В этом случае, функция вернёт число где значения сигнала размещены в битах. Последний элемент массива будет соответствовать младшему биту результата.
Если перед вызовом не вызывалась функция pinMode , пин будет автоматически переведён в режим 'input' .
digitalWrite(pin, value)Устанавливает цифровой сигнал на пине pin : логическую единицу, если value — 1 или true , логический ноль, если value — 0 или false .
В качестве pin можно передать массив пинов. В этом случае считается, что число value кодирует значения для пинов на соответствующих позициях битов. Последнему элементу массива pin соответствует младший бит value . Выставление значений происходит последовательно, начиная с последнего пина, т.е. справа налево. Вы можете использовать один и тот же пин в массиве несколько раз, чтобы реализовать очень короткий импульс.
Если перед вызовом не вызывалась функция pinMode , пин будет автоматически переведён в режим 'output' .
getPinMode(pin)Возвращает текущий режим работы пина pin в виде строковой константы. Смотрите pinMode для возможных значений.
pinMode(pin[, mode])Устанавливает режим работы пина pin в соответствие с mode :
Функции для работы с пинами — например digitalRead или digitalWrite — самостоятельно устанавливают нужный режим работы пина, если вы предварительно не вызвали pinMode явно. Чтобы вернуть автоматический режим, вызовите pinMode без параметра mode .
setWatch(callback, pin [, opts])Заставляет платформу вызвать функцию callback при изменении цифрового сигнала на входе pin . В качестве opts принимается объект с полями:
В callback при вызове система передаёт параметр-объект с полями:
Функция возвращает число-идентификатор, который можно передать в clearWatch , чтобы отменить наблюдение за пином.