Using Chrome Extensions

What are Chrome extensions?

Chrome extensions add additional functionality to the browser. They can automate tasks, introduce new features, or modify browser behavior.

How to use a Chrome extension

Obtaining an extension ID

To use a Chrome extension in a session, you need to provide the ID of the extension you want to use. You can find the extension ID by navigating to its page in the Chrome Web Store. The ID is the last part of the URL. For example, the extension url for the “Grammarly” is

https://chromewebstore.google.com/detail/grammarly-ai-writing-and/kbfnbcaeplbcioakkpcpgfkobkghlhen 

and ID is kbfnbcaeplbcioakkpcpgfkobkghlhen.

Using extensions in a session

Once you have the ID(s) of the extensions you want to use, you can pass them to the sessions.create method.

1
const session = await client.sessions.create({
2
  configuration: {
3
    extensionIds: ["<extension-id-1>", "<extension-id-2>"]
4
  }
5
});

Airtop will automatically install the extensions and make them available in the session.

Configuring an extension

You can access extension information and configuration pages by creating a live-view and navigating to configuration page of the extension. When the extension is installed, a new button will appear in the navigation bar, allowing you to access extension options and popup pages.

Saving extension configuration on session termination

Extension configurations are saved as part of the profile. In order to save the profile, you must call session.saveProfileOnTermination with the name of the profile.

1
await client.sessions.saveProfileOnTermination(session.data.id, "MY_CONFIGURATION_NAME");
2
await client.sessions.terminate(session.data.id);

You can read more about profiles here.

Restoring an existing extension configuration

You can restore an existing extension configuration by specifying profile name and extension IDs in the sessions.create method.

1
const session = await client.sessions.create({configuration: {
2
  profileName: "MY_PROFILE_NAME",
3
  extensionIds: ["<extension-id-1>", "<extension-id-2>"]
4
}});