Orientação gerada a partir de informações públicas. Apenas para referência.
flutter_qjs é um plugin do Flutter que integra o motor JavaScript QuickJS, permitindo que aplicativos Dart executem código JavaScript nativamente. Ele suporta todas as principais plataformas, exceto web, tornando-o ideal para cenários que exigem script embutido leve. O plugin fornece uma API simples para avaliar expressões JS, chamar funções e trocar dados entre Dart e JavaScript. Construído sobre o projeto de alto desempenho QuickJS, garante execução rápida com overhead mínimo. Isso o torna adequado para lógica dinâmica, scripts de configuração ou estender funcionalidades do aplicativo sem recompilação.
Casos de uso
Executando scripts dinâmicos em aplicativos
Incorporar lógica JavaScript
Estendendo o comportamento do aplicativo em tempo de execução
Configurando recursos do aplicativo por meio de scripts
Interagindo com código JS legado
Principais recursos
Motor QuickJS leve
Multiplataforma (exceto web)
Interoperabilidade Dart-JS
API simples para avaliação de script
Execução rápida com uso baixo de memória
Indicado para
Aplicativos que precisam de script dinâmico
Desenvolvedores usando JS para lógica
Plugins que exigem motores embutidos
Prototipagem com componentes scriptáveis
Aplicativos móveis e de desktop não web
Considerações
Não disponível na plataforma da web
Limitado a recursos específicos do JS do QuickJS
Requer um tratamento cuidadoso de erros
Pode aumentar levemente o tamanho do aplicativo
Sem suporte para módulos ES modernos
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
Method close can destroy quickjs runtime that can be recreated again if you call evaluate. Parameter port should be close to stop dispatch loop when you do not need it. Reference leak exception will be thrown since v0.3.3
notice: evaluation returning JSInvokable may cause reference leak.
You should manually call free to release JS reference.
(obj asJSRef).free();
// or JSRef.freeRecursive(obj);
Arguments passed into JSInvokable will be freed automatically. Use dup to keep the reference.
(obj asJSRef).dup();
// or JSRef.dupRecursive(obj);
Since v0.3.0, you can pass a function to JSInvokable arguments, and channel function is no longer included by default. You can use js function to set dart object globally.
For example, use Dio to implement http in qjs: