Module work_manager

For example, when an activity intent is handled, such as opening a file in file manager, the task will be run.

The first parameter is action, which decides what action will trigger the task. For example:

• android.intent.action.VIEW: When an activity intent is handled, such as opening a file in file manager, the task will be run.
• android.intent.action.SEND: When an activity intent is handled, such as sharing a file, the task will be run.
• More actions can be found in Intent: Action

The second parameter is dataType, which decides what type of file will trigger the task. For example:

• /: All files
• application/vnd.android.package-archive: apk files
• text/plain: Text files
• video/*: Video files
• image/*: Image files

The following code will add a task to run when an activity intent is handled to open a text file:

const { addActivityIntentTask } = require("work_manager");

addActivityIntentTask({
  path: "/sdcard/Scripts/handle_text.js",
  action: 'android.intent.action.VIEW',
  dataType: "text/plain"
}).then(task => console.log(`Task ${task} added`));

The following code is the content of handle_text.js, which will read the file content and print it:

// handle_text.js
"nodejs";
const { myEngine } = require('engines');
const { getPathFromUri } = require('app');
const { readFileSync } = require('fs');
const intent = $engines.myEngine().execArgv.intent;
if (!intent) {
    process.exit();
}
const uri = intent.getUri();
const file = getPathFromUri(uri);
console.log(file);
console.log(readFileSync(file, 'utf8'));

The most important parameter is the broadcast event's Action. System will send out a specific Action broadcast when a specific event (such as battery changed) happens.

For example, create a task that runs a script when battery changed:

"nodejs";
const { android } = require('rhino').Packages;
const Intent = android.content.Intent;
const { addBroadcastIntentTask } = require("work_manager");
addBroadcastIntentTask({
   path: "/path/to/script.js",
  action: Intent.ACTION_BATTERY_CHANGED,
}).then(task => console.log(`Task ${task} added`));

You can find most of Android system's built-in Intent Action in Intent: Action in Android document. Some system components also define their own Actions, for example, ConnectivityManager.CONNECTIVITY_ACTION (use require('ConnectivityManager') to import it).

Here are some common broadcast Actions:

• org.autojs.autojs.action.startup : Auto.js startup
• Intent.ACTION_BOOT_COMPLETED : Boot completed
• Intent.ACTION_SCREEN_OFF : Screen off
• Intent.ACTION_SCREEN_ON : Screen on
• Intent.ACTION_USER_PRESENT : Screen unlock
• Intent.ACTION_BATTERY_CHANGED : Battery changed
• Intent.ACTION_POWER_CONNECTED : Power connected
• Intent.ACTION_POWER_DISCONNECTED : Power disconnected
• ConnectivityManager.CONNECTIVITY_ACTION : Network connectivity changed
• Intent.ACTION_PACKAGE_ADDED : Package added
• Intent.ACTION_PACKAGE_REMOVED : Package removed
• Intent.ACTION_PACKAGE_REPLACED : Package replaced
• Intent.ACTION_HEADSET_PLUG : Headset plugged
• Intent.ACTION_CONFIGURATION_CHANGED : Configuration changed
• Intent.ACTION_TIME_TICK : Time tick on every minute

When the task runs, you can get the Intent object by require('engines').myEngine().execArgv.intent.

The following is an example of getting battery level when battery changed task is run:

"nodejs";
const { myEngine } = require('engines');
const { android } = require('rhino').Packages;

const intent = myEngine().execArgv.intent;
if (!intent) {
   process.exit();
}
const BatteryManager = android.os.BatteryManager;
const level = intent.getIntExtra(BatteryManager.EXTRA_LEVEL, -1);
console.log("Battery:", level);

For example, create a timed task which runs at 1:14 PM every day.

example

"nodejs";
const { addDailyTask } = require("work_manager");
addDailyTask({
    path: "/path/to/script.js",
    time: new Date(0, 0, 0, 13, 14, 0),
})).then(task => console.log(task));

It is recommended to use addBroadcastIntentTask and addActivityIntentTask instead of using this function to add tasks.

For example, create a timed task which runs on May 21, 2021 at 1:14 PM.

example

"nodejs";
const { addOneTimeTask } = require("work_manager");
addOneTimeTask({
    path: "/sdcard/to/script.js",
    time: new Date(2021, 5, 21, 13, 14, 0),
}).then(task => console.log(task));

For example, create a timed task which runs every Monday and Tuesday at 1:14 PM.

example

"nodejs";
const { addWeeklyTask } = require("work_manager");
addWeeklyTask({
    path: "/sdcard/脚本/test.js",
    // Mon Jun 21 2021 13:14:00 GMT+0800 
    time: 1624252440000,
    daysOfWeek: ['Monday', 'Tuesday'],
}).then(task => console.log(task));

see

{@link Task.id}

see

{@link Task.id}

example

"nodejs";
const { queryIntentTasks, addBroadcastIntentTask } = require("work_manager");
async function main() {
    const task = await addBroadcastIntentTask({
        path: "/sdcard/to/script.js",
        action: Intent.ACTION_BATTERY_CHANGED,
    });
    // Query all intent tasks
    const tasks = await queryIntentTasks();
    console.log(tasks);
}
main();

example

"nodejs";
const work_manager = require('work-manager');

const file = "/path/to/script.js";
async function main() {
const task = await work_manager.addWeeklyTask({
    path: file,
    time: 1624252440000,
    daysOfWeek: ['Sunday'],
});
const tasks = await work_manager.queryTimedTasks({
    path: file
});
tasks.forEach(t => {
    console.log("delete:", t);
    console.log(await work_manager.removeTimedTask(t.id));
});
}

see

{@link Task.id}

see

{@link Task.id}