Обзор синтаксиса JavaScript

Скрипт

изменяет только текущую копию конфигурации и не изменяет напрямую исходный текст подписки.

生成一个符合 YumeBox 运行时约束的 JavaScript 覆写

Процесс выполнения

Инициализировать среду выполнения

Инициализирует среду выполнения JavaScript и встроенные методы при первом появлении файла .js в текущей цепочке переопределения.

Передать объект конфигурации

Текущая конфигурация преобразуется в объект JavaScript и передается как параметр profile.

выполнить основной

Скрипт может изменить profile напрямую или вернуть новый объект конфигурации. Поддерживаются как синхронные возвращаемые значения, так и завершенные промисы.

Проверьте возвращаемое значение

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

Та же самая цепочка переопределений повторно использует среду выполнения JavaScript, но каждый скрипт выполняется в изолированной области; main, переменные и объявления предыдущего скрипта не передаются в следующий скрипт.

ДЕРЖАТЬ_30

Минимальный скрипт

最小覆写.js

function main(profile) {
  return profile;
}

Изменить поля

修改字段.js

function main(profile) {
  profile["log-level"] = "info";
  profile["mixed-port"] = 7890;
  return profile;
}

ожидаемая разница

修改字段 diff.js

function main(profile) {
-  profile["log-level"] = "info"; 
+  profile["log-level"] = "debug"; 
  return profile;
}

// [!code --] и // [!code ++] используются только для отображения различий в документации и сами являются законными комментариями JavaScript.

Изменение состояния

按模式修改.js

function main(profile) {
  if (profile.mode === "global") {
    profile["log-level"] = "warning";
  }
  return profile;
}

Асинхронный скрипт

异步 main.js

async function main(profile) {
  await Promise.resolve();
  profile.extra = "ready";
  return profile;
}

Обещание должно в конечном итоге быть выполнено; он вернет async main(profile) did not settle, когда он находится в ожидании.

Требования к возвращаемому значению

возвращаемое значение	результат
Объект конфигурации	Успех, переход к следующей перезаписи.
Обещание выполнено с объектом результата	успех.
Массив, строка, число, логическое значение, `null` или `undefined`	Ошибка: `JS override result must be an object`.
Объект, который невозможно преобразовать в JSON	Сбой и остановка компиляции.

Пример ошибки:

错误的返回值.js

function main(profile) {
  return profile.rules;
}

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

Начало

Руководства

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

Другое

Обзор синтаксиса JavaScript

Процесс выполнения

ДЕРЖАТЬ_30

Минимальный скрипт

Изменить поля

ожидаемая разница

Изменение состояния

Асинхронный скрипт

Требования к возвращаемому значению

​Процесс выполнения

​ДЕРЖАТЬ_30

​Минимальный скрипт

​Изменить поля

​ожидаемая разница

​Изменение состояния

​Асинхронный скрипт

​Требования к возвращаемому значению

Процесс выполнения

ДЕРЖАТЬ_30

Минимальный скрипт

Изменить поля

ожидаемая разница

Изменение состояния

Асинхронный скрипт

Требования к возвращаемому значению