Библиотека dart:js_util

Вспомогательные методы для работы с объектами взаимодействия с JavaScript, аннотированными package:js, в случаях, когда вызываемое имя неизвестно во время выполнения.

Используйте эти методы только в тех случаях, когда добиться того же эффекта с помощью аннотаций @JS() невозможно.

Свойства

globalThis → Object

только для чтения

objectPrototype → Object?

только для чтения

Возвращает прототип Object. Эквивалентно Object.prototype.

Функции

add<T>(Object? first, Object? second) → T

Выполняет сложение в JavaScript (+) для двух значений.

callConstructor<T>(Object constr, List<Object?>? arguments) → T

callMethod<T>(Object o, String method, List<Object?> args) → T

createDartExport<T extends Object>(T dartObject) → Object

Принимает объект Dart, помеченный как доступный для экспорта, и создаёт литерал объекта JS, делегирующий вызовы этому классу Dart. Сведения о том, что считается «доступным для экспорта» для класса Dart, см. в аннотации @JSExport. Литерал объекта будет представлять собой карту экспортируемых имён (то есть записанных имён членов экземпляра или их переименованных вариантов) и соответствующих им членов экземпляра Dart.

createStaticInteropMock<T extends Object, U extends Object>(U dartMock, [Object? proto = null]) → T

Принимает тип @staticInterop T и экземпляр dartMock класса Dart U, реализующий внешние члены расширения T, и создаёт пересылающий вызовы макет.

dartify(Object? o) → Object?

По сути, обратная операция к jsify: dartify принимает объект JavaScript и преобразует его в объект Dart. Поддерживаются только примитивы JS, массивы и JS-объекты, похожие на «map».

divide<T>(Object? first, Object? second) → T

Выполняет деление в JavaScript (/) для двух значений.

equal<T>(Object? first, Object? second) → bool

Выполняет сравнение на равенство в JavaScript (==) для двух значений.

exponentiate<T>(Object? first, Object? second) → T

Выполняет возведение в степень в JavaScript (**) для двух значений.

getProperty<T>(Object o, Object name) → T

greaterThan<T>(Object? first, Object? second) → bool

Выполняет сравнение двух значений на большее в JavaScript (>).

greaterThanOrEqual<T>(Object? first, Object? second) → bool

Выполняет сравнение двух значений на большее или равное в JavaScript (>=).

hasProperty(Object o, Object name) → bool

instanceof(Object? o, Object type) → bool

Проверяет, является ли o экземпляром type.

instanceOfString(Object? element, String objectType) → bool

Аналогично instanceof, но вместо объекта-конструктора принимает String с именем объекта.

isJavaScriptArray(dynamic value) → bool

Возвращает true, если данный объект является массивом JavaScript.

isJavaScriptSimpleObject(dynamic value) → bool

Возвращает true, если данный объект является простым объектом JavaScript.

jsify(Object object) → dynamic

Рекурсивно преобразует коллекцию, подобную JSON, в представление, совместимое с JavaScript.

lessThan<T>(Object? first, Object? second) → bool

Выполняет сравнение двух значений на меньшее в JavaScript (<).

lessThanOrEqual<T>(Object? first, Object? second) → bool

Выполняет сравнение двух значений на меньшее или равное в JavaScript (<=).

modulo<T>(Object? first, Object? second) → T

Вычисляет остаток от деления в JavaScript (%) для двух значений.

multiply<T>(Object? first, Object? second) → T

Выполняет умножение в JavaScript (*) для двух значений.

newObject<T>() → T

notEqual<T>(Object? first, Object? second) → bool

Выполняет сравнение двух значений на неравенство в JavaScript (!=).

objectGetPrototypeOf(Object? object) → Object?

Возвращает прототип данного объекта. Эквивалентно Object.getPrototypeOf.

objectKeys(Object? object) → List<Object?>

Возвращает ключи данного объекта. Эквивалентно Object.keys(object).

promiseToFuture<T>(Object jsPromise) → Future<T>

Преобразует Promise JavaScript в Future Dart.

setProperty<T>(Object o, Object name, T? value) → T

strictEqual<T>(Object? first, Object? second) → bool

Выполняет строгое сравнение двух значений на равенство в JavaScript (===).

strictNotEqual<T>(Object? first, Object? second) → bool

Выполняет строгое сравнение двух значений на неравенство в JavaScript (!==).

subtract<T>(Object? first, Object? second) → T

Выполняет вычитание в JavaScript (-) для двух значений.

Исключения / ошибки

NullRejectionException

Исключение, возникающее, если Promise отклонён со значением null или undefined.