Размер
Встроенные функции и константы
Play

Встроенные функции и константы

Значение положительной бесконечности. Результат 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 , чтобы отменить наблюдение за пином.

📎📎📎📎📎📎📎📎📎📎