# chrome-inject-eval

> 🔮use eval in chrome extension v3+

Latest version **1.0.4** (published 2022-09-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install chrome-inject-eval
pnpm add chrome-inject-eval
yarn add chrome-inject-eval
bun add chrome-inject-eval
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.4 |
| Published | 2022-09-07 |
| First published | 2022-09-04 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 2.6 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 35 |
| Author | SourceHeartLock |
| Maintainers | sourcebug |
| Keywords | chrome, eval, eval5, evalute, chrome-eval, chrome extension, chrome extension v3 |

## Links

- npm: https://www.npmjs.com/package/chrome-inject-eval
- Repository: https://github.com/GrinZero/chrome-inject-eval
- Homepage: https://github.com/GrinZero/chrome-inject-eval#readme
- Issues: https://github.com/GrinZero/chrome-inject-eval/issues
- npm.io page: https://npm.io/package/chrome-inject-eval

## Dependencies (2)

- [eval5](https://npm.io/package/eval5.md) ^1.4.7
- [@babel/standalone](https://npm.io/package/@babel/standalone.md) ^7.18.13

## Recent versions

- 1.0.4 (latest) — 2022-09-07
- 1.0.3 — 2022-09-05
- 1.0.2 — 2022-09-05
- 1.0.1 — 2022-09-04
- 1.0.0 — 2022-09-04

## README

# chrome-inject-eval

> **use eval in chrome extension v3+**

你可以通过引入本包从而实现在 chrome 插件 v3 版本中使用 eval

## Start

我们推荐你使用npm安装而不是yarn或者pnpm，因为chrome插件开发时（没有webpack/rollup时）如果使用pnpm这种软链接安装的包管理工具是会出问题的
```bash
npm i chrome-inject-eval
```

## Usage

### manifest.json

```json
{
  ...
  "content_scripts": [
    {
      ...
      "js": [
        "./node_modules/chrome-inject-eval/dist/umd.min.js",
        "./src/[your inject].js"
      ],
      ...
    }
  ],
  ...
}
```

### [your inject].js

- 基本

```js
const evil = evalCore.getEvalInstance(window);

evil("const a=1;");
console.log(a); // 1
```

- 高阶

```js
const { evalModule, transformCode } = evalCore;

const { Interpreter } = evalModule;
Interpreter.global = window;
const interpreter = new Interpreter();
// 现在你可以使用eval5的所有功能

interpreter.evaluate(transformCode("const a=1;"));

console.log(a); // 1
```

## Caveats

`chrome-inject-eval`的导出对象有三个属性，其中`evalModule`本质上等于`require("eval5")`，而 transform 则是通过 babel 把字符串编译成 ES5 代码，所以如果想使用更多 eval 相关的功能，可以参考 [eval5官网](https://github.com/bplok20010/eval5)

```js
const evil = require("eval5");
const { transform } = require("@babel/standalone");

const transformCode = (codeStr) =>
  transform(codeStr, { presets: ["env"] }).code;

const getEvalInstance = (obj) => {
  const interpreter = new evil.Interpreter(obj, {
    timeout: 1000,
  });
  return (codeStr) => interpreter.evaluate(transformCode(codeStr));
};

module.exports = {
  evalModule: evil,
  getEvalInstance,
  transformCode,
};
```

---
_Source: https://npm.io/package/chrome-inject-eval · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._