FastInject

🚀 FastInject 是一个轻量级 JavaScript 生成引擎。它允许你使用纯 Kotlin DSL 编写 Web 自动化逻辑，生成 JavaScript

FastInject-Core 是纯 Kotlin 库，可以轻易集成到 Kotlin/Java 项目中

FastInject-Android 扩展驱动支持 Android WebView、腾讯的 X5 WebView，可以通过扩展库的扩展函数 emit() 方法从 JavaScript 层获取数据

🌟 核心特性

• 类型引用: ElementRef 和 ValueRef 确保了 DOM 节点与变量在 Kotlin 和 JS 之间的安全映射
• 声明式控制流: 支持 forEach、ifExists 以及原生风格的集合操作
• 异步链: 内置 waitElement、setTimeOut 及 then 回调，轻松应对动态加载的网页
• 自动化调试: 集成 log、warn、info 等方法，自动对接浏览器控制台
• 环境隔离: 自动生成 IIFE（立即执行函数），避免污染全局作用域

📦 安装

在你的根目录 settings.gradle 中添加 JitPack 仓库：

dependencyResolutionManagement {
repositories {
maven { url 'https://jitpack.io' }
}
}

在模块级 build.gradle 中添加依赖：

dependencies {
// 核心 DSL 逻辑
implementation "com.github.SpeechlessMatt.FastInject:fastinject-core:0.0.2"// Android WebView 扩展驱动
implementation "com.github.SpeechlessMatt.FastInject:fastinject-android:0.0.2"
}

💻 示例代码

1. 基础 DOM 操作

fastInject {
val container = find("#main-app")
container.find(".submit-btn").click()
// 模拟人手输入val userInput = createKVar("Hello FastInject!")
find("#input-field").simulateInput(userInput)
}

2. 异步等待与回调

fastInject(onMessage = { data ->Log.d("FastInject", "收到回传: $data")
}) {
// 等待元素出现（超时 5000ms）后执行逻辑
waitElement(".dynamic-list", ms =5000).then { list ->val firstItem = list.find(".item")
firstItem.click()
}
}

3. 循环处理

fastInject {
findAll(".checkbox").forEach { check ->
check.click()
}
}

4. 条件处理

fastInject {
val num = kValOf(10)
val limit = kValOf(5)
// 使用 condition 链式调用处理复杂的逻辑分支
condition(num gt limit) {
log("数值超限:", num)
}.otherWiseIf(num eq limit) {
log("数值刚好达标")
}.otherWise {
log("数值在安全范围内")
}
// 也可以直接使用原生 JS 表达式
condition("window.innerWidth > 1080") {
log("当前是桌面端布局")
}
}

🛠 核心 API 概览

分类	常用方法 / 特性
元素查找	find, findAll
变量管理	kVarOf, kCreateVar, VarOf, createVar, wrapVar
算术运算	+, -, *, /, % (支持 ValueRef 运算符重载)
逻辑判断	eq, neq, gt, ge, lt, le (中缀表达式)
流程控制	condition (if/else 链), ifExists, forEach, forEachIndexed
属性获取	size, text, innerText, value
交互模拟	click, simulateInput, input, megaClick
异步/定时	waitElement, setTimeOut, then, disableTimeCheck
日志/注入	log, execJs, execIsolatedJs

📄 开源协议

本项目采用 Apache License 2.0