Каждое сообщение компилятора и исполнителя LootScript начинается с кода вида LS2008. Код не меняется между версиями и не зависит от языка интерфейса, поэтому по нему удобно искать: здесь собраны все коды, которые может показать терминал, с текстом сообщения, причиной и способом исправления.

Сообщения выводятся по-русски, если интерфейс терминала на русском, и по-английски на любом другом языке. Сначала — ошибки, которые встречаются чаще всего, затем ошибки выполнения и полная таблица.

Где видны ошибки

При компиляции. Редактор компилирует скрипт в каждой паузе набора. Найденное попадает во вкладку «Проблемы» в нижней части редактора: код, текст и позиция вида «Стр 6:6». Двойной щелчок по строке переводит курсор к месту ошибки. В заголовке редактора отображается итог: «ок · 12 мс», «предупреждений: 2» или «ошибок: 1».

При выполнении. Скрипт без ошибок компиляции может остановиться на каком-то баре: закончился бюджет операций, индекс вышел за границы массива, неизвестен инструмент. Тогда во вкладке «Вывод» появится строка «Скрипт остановлен: LS6004: …», а в окне тестера стратегий — та же причина. Остальные скрипты, панели и сам терминал продолжают работать.

Диагностики бывают трёх уровней:

Как устроены коды

Частые ошибки компиляции

LS1009 — нет объявления скрипта

«Нет объявления скрипта — начните с indicator(“Название”)». Первым оператором файла должно стоять indicator(...), strategy(...) или library(...). Эта же ошибка появляется, если объявление есть, но выше него что-то написано. Комментарии и директива #version 1 не мешают.

// Так нельзя: объявление не первое
len = input.int(14, "Длина")
indicator("RSI")

indicator("RSI")
len = input.int(14, "Длина")

Второе объявление в том же файле даёт LS1008: у скрипта оно одно.

LS2002 — неизвестное имя

«Неизвестное имя «…» — проверьте написание или объявите его выше». Чаще всего это опечатка или функция без своего пространства имён: все индикаторные функции живут в ta, математика — в math, цвета — в color.

avg = sma(close, 20)

avg = ta.sma(close, 20)

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

LS2008 — сравнение с na

«Сравнение с na всегда ложно — используйте na(x)». Любое сравнение с na, включая == и !=, даёт false, поэтому компилятор такую запись не пропускает.

x = ta.sma(close, 50)
plot(x == na ? close : x)

x = ta.sma(close, 50)
plot(na(x) ? close : x)

Короче то же самое пишется через ??: plot(x ?? close).

LS2014 — значение меняется от бара к бару там, где нужна постоянная

««…» в «…» требует значение не слабее input, а передано series — возьмите input.*(…) или литерал». Длина окна ta.* должна быть известна до первого бара. Длина, которую выбирают по условию на каждом баре, не подходит.

len = close > open ? 10 : 20
avg = ta.sma(close, len)

Посчитайте оба варианта и выбирайте результат, а не длину:

fast = ta.sma(close, 10)
slow = ta.sma(close, 20)
avg  = close > open ? fast : slow

Если длину должен задавать пользователь, возьмите её из input.int(...).

LS3004 — вызов ta.* зависит от переменной из ветки

«Аргумент «…» нельзя вычислить вне ветки — вынесите вызов ta.* на верхний уровень». Функции ta.* помнят прошлые бары, поэтому компилятор вычисляет их на каждом баре, даже если вызов написан внутри if. Если аргумент объявлен только внутри ветки, на других барах его просто нет.

var float avgBody = na
if close > open {
    body = close - open
    avgBody := ta.sma(body, 10)
}

body    = close - open
avgBody = ta.sma(body, 10)

LS2017, LS2007, LS1006 — строки, условия и сравнения

У этих трёх ошибок общая причина: LootScript не приводит типы молча.

LS2018 и LS2019 — имя уже занято

««…» уже объявлено в этой области» (LS2018) — переменную объявили второй раз через =. Чтобы изменить значение, используйте :=.

level = high
level := low

««…» затеняет встроенное имя — выберите другое» (LS2019) — переменная, функция или тип названы так же, как встроенный ряд или функция: close, time, hour, volume. Переименуйте: startHour вместо hour. Имена пространств вроде color или position для переменных можно использовать.

LS2004 и LS2005 — аргументы вызова

««…» ожидает … аргумент(ов), а передано …» (LS2004) и «У «…» нет параметра «…»» (LS2005). Сверьте вызов с сигнатурой в справочнике: имена параметров пишутся ровно так, как там указано.

plot(close, colour = color.red)

plot(close, color = color.red)

LS3011 и LS5011 — стратегии

«strategy.* доступно только в strategy(…)» (LS3011): заявки и состояние позиции есть только у скрипта, объявленного через strategy(...). Замените indicator("…") на strategy("…").

«Стратегия читает «…»: у стакана и ленты нет истории, бэктест был бы вымыслом» (LS5011): стратегия проверяется на истории, а у book.* и tape.* истории нет — на каждом прошлом баре там na.

strategy("Перекос стакана")
if book.imbalance(10) > 0.5 {
    strategy.entry("L", strategy.long)
}

Для истории стакана есть пространство depth: там, где стакан записан, оно даёт значения на каждом баре.

strategy("Перекос стакана")
if depth.imbalance(1.0) > 0.5 {
    strategy.entry("L", strategy.long)
}

LS5000–LS5006 — предупреждения о перерисовке

Эти предупреждения не мешают скрипту работать. Они говорят, что линия на истории будет выглядеть иначе, чем её видели вживую:

• LS5001 — до графика доходит значение, которое бывает только на живом баре (barstate.isrealtime, barstate.isnew).
• LS5000 — до графика доходит переменная varip: она копит тики живого бара, которых в истории нет.
• LS5006 — до графика доходят book.* или tape.*: на истории ряд пуст.
• LS5003 — значение старшего таймфрейма из request.security без [1]: незакрытый бар ещё изменится.
• LS5002 — lookahead = true в request.security: на истории скрипт видит будущее.
• LS5005 — до графика доходит math.random или timenow: два прогона дадут разные линии.

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

LS3016 — настройка принята и ничего не делает

Это сведение, а не ошибка. Оно встречается в скриптах, перенесённых с других платформ: параметр существует ради совместимости, но в терминале ни на что не влияет. Вторая часть сообщения объясняет почему.

Ошибки выполнения

Ошибка выполнения останавливает скрипт на том баре, где она случилась. Текст появляется во вкладке «Вывод» в виде «Скрипт остановлен: LS6004: …».

LS6004 и LS6005 — скрипт работает слишком долго

«Скрипт исчерпал бюджет операций на бар — упростите цикл» (LS6004) и «Скрипт превысил лимит времени на проход» (LS6005). У каждого бара есть бюджет в 2 000 000 операций. Время тоже ограничено: весь проход по истории — 2 секунды, один тик живого бара — 20 мс. Почти всегда причина — цикл, который не заканчивается или обходит слишком много данных на каждом баре.

var int n = 0
i = 0
while i < 10 {
    n := n + 1
}

var int n = 0
i = 0
while i < 10 {
    n := n + 1
    i := i + 1
}

LS6002 и LS5004 — чтение будущего

Индекс истории x[n] не может быть отрицательным: close[-1] означал бы следующий бар. Если отрицательное число написано прямо в тексте, компилятор остановит его сразу (LS5004). Если оно получилось при вычислении, скрипт остановится на баре с ошибкой «Отрицательное смещение истории — читать будущее нельзя» (LS6002). Индекс больше числа загруженных баров ошибкой не считается — он даёт na.

LS6001, LS6007, LS6019 — коллекции и объекты

• LS6001 «Индекс … вне границ» — array.get, array.set или matrix.get за пределами размера. Проверяйте array.size(a) перед обращением.
• LS6007 «Обращение к пустому объекту (na)» — коллекцию объявили, но не создали: var array<float> a = na, а затем a.push(x). Создайте её через array.new<float>().
• LS6019 «Объект рисования уже удалён или вытеснен по потолку — создайте его заново». Одновременно живут 500 объектов одного вида, самый старый вытесняется. Поднимите предел через maxLinesCount, maxLabelsCount или maxBoxesCount в объявлении либо переиспользуйте объект через set_*.

LS6017 и LS6018 — инструмент и таймфрейм в request.security

«Символ «…» неизвестен — проверьте формат «ПЛОЩАДКА:СИМВОЛ» или задайте ignore_invalid_symbol = true» (LS6017) и «Таймфрейм «…» не разбирается — ожидается «5», «60», «4h», «1D», «1W»» (LS6018). С ignore_invalid_symbol = true неизвестный инструмент даёт na вместо остановки.

Пределы выполнения

Когда ошибки нет, а значения нет

Многие ситуации, которые в других языках роняют программу, в LootScript дают na — пропуск на графике, а не остановку:

• арифметика с na даёт na: close - x при пустом x — тоже пусто;
• x[n] глубже начала истории — na;
• целочисленное деление на ноль — na, а дробное деление на ноль скрипт не останавливает;
• book.*, tape.* и screener.* на исторических барах — na;
• кластеры, дельта, открытый интерес и история стакана — na на барах, где данных нет. Проверяйте cluster.available, delta.available и соседние флаги;
• ta.* на первых барах, пока окно не заполнилось, — na.

na на графике никогда не рисуется нулём: линия прерывается. Чтобы подставить значение, используйте nz(x), x ?? запасное или fixnan(x).

Все коды

LS0001–LS0009 и LS0999 — чтение текста

LS1000–LS1012 — разбор

LS2000–LS2030 — типы и имена

LS3000–LS3033 — смысл программы

LS4000–LS4009 — пределы компиляции

LS5000–LS5013 — перерисовка и тестер

LS6000–LS6036 — выполнение

Дальше