随着程序的不断更新，我们会发现，函数的定义和调用是一致的。

Functions - 函数


`string_decoder`用于把 Buffer 转换为字符串

## 基本用法

```js
const {StringDecoder} = require('string_decoder')
const decoder = new StringDecoder('utf8')
const buffer = Buffer.from('Hello World')
const str = decoder.write(buffer)
console.log(str)
```

## 方法

- stringDecoder.write(buffer[, encoding])
- stringDecoder.end(buffer[, encoding])

`write`方法把 buffer 转换为字符串，`end`方法把 buffer 转换为字符串并返回。

```js
const {StringDecoder} = require('string_decoder')
const decoder = new StringDecoder('utf8')

decoder.write(Buffer.from([0xe2]))
decoder.write(Buffer.from([0x82]))
console.log(decoder.end(Buffer.from([0xac])))
```


string_decoder用于把Buffer转换为字符串

Node.js - StringDecoder


Next.js 预渲染支持两种方式：

- SSG 预渲染
- SSR 预渲染

## SSG 预渲染

SSG 预渲染是指在构建时生成 HTML，可以在没有数据的情况下完成，在这种情况下，HTML 页面将准备就绪，而无需预先获取数据，然后开始渲染。

数据可以稍后或应要求提供。

优点：这种方式可以解决白屏问题、SEO 问题
缺点：所有用户看到的都是同一个页面，无法生成用户相关内容

```js
import Link from 'next/link'
import Head from 'next/head'
import Container from '../../components/container'

export default function FirstPost(props) {
  return (
    <>
      <Container>
        <Head>
          <title>My First Post</title>
        </Head>
        <h1>My First Post</h1>
        <h2>
          <Link href="/">
            <a>Home</a>
          </Link>
          <div>Next stars: {props.stars}</div>
        </h2>
      </Container>
    </>
  )
}

export async function getStaticProps() {
  const res = await fetch('https://api.github.com/repos/vercel/next.js')
  const json = await res.json()
  return {
    props: {stars: json.stargazers_count}
  }
}
```

## SSR 预渲染

后端将页面渲染，返回 HTML String 格式，传递到前端，前端进行 hydrate() ,会保留 HTML 并附上时间监听，也就是说后端渲染 HTML，前端添加监听。

前端也会渲染一次，用以确保前后端渲染结果一致

每个组件都有一个特殊的方法`getStaticProps`，可用于获取数据并作为页面的属性传递数据。

## 使用 getServerSideProps

```js
import Link from 'next/link'
import Head from 'next/head'

function HomePage(props) {
  return (
    <>
      <Head>
        <title>Welcome to Next.js!</title>
      </Head>
      <div>Welcome to Next.js!</div>
      <Link href="/posts/first">
        <a>First Post</a>
      </Link>
      <br />
      <div>Next stars: {props.stars}</div>
      <img src="/logo.png" alt="TutorialsPoint Logo" />
    </>
  )
}

export async function getServerSideProps(context) {
  const res = await fetch('https://api.github.com/repos/vercel/next.js')
  const json = await res.json()
  return {
    props: {stars: json.stargazers_count}
  }
}

export default HomePage
```

启动服务

```bash
npm run dev
```


Next.js - Pre-Rendering


![YyhZzD](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/YyhZzD.jpg)

## 向浏览器扩展添加可选项

打开`manifest.json`，添加 options 选项，注册选项页面。

```json
{
  "options_ui": {
    "page": "options.html",
    "open_in_tab": false
  }
}
```

创建`options.html`

```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <meta http-equiv="X-UA-Compatible" content="ie=edge" />
    <title>DDT Pop-up</title>
    <link rel="stylesheet" type="text/css" href="./css/style.css" />
  </head>
  <body>
    <div id="options"></div>
    <script type="module" src="src/options/index.jsx"></script>
  </body>
</html>
```

修改`src/index.jsx`

```jsx
import ReactDOM from 'react-dom'
import {App} from './App'

const app = document.getElementById('options')
ReactDOM.render(<App />, app)
```

修改`src/App.jsx`

```jsx
import {useState} from 'react'

export function App() {
  const [color, setColor] = useState('indigo')

  chrome.storage.sync.get('color', (storedColor) => {
    setColor(storedColor.color)
  })

  const pickColor = (pickedValue) => {
    setColor(pickedValue)
    chrome.storage.sync.set({color: pickedValue})
    window.close()
  }

  return (
    <div className="m-4">
      <select
        onChange={(event) => pickColor(event.target.value)}
        value={color}
        className="block w-full p-4 text-sm text-gray-900 border border-gray-300 rounded-lg bg-gray-50 focus:ring-indigo-500 focus:border-indigo-500 dark:bg-gray-700 dark:border-gray-600 dark:placeholder-gray-400 dark:text-white dark:focus:ring-indigo-500 dark:focus:border-indigo-500"
      >
        <option>Pick a color</option>
        <option value="indigo">Indigo</option>
        <option value="pink">Pink</option>
        <option value="purple">Purple</option>
        <option value="red">Red</option>
      </select>
    </div>
  )
}
```

修改`vite.config.js`，多页面打包配置

```js
import {defineConfig} from 'vite'
const {resolve} = require('path')
import react from '@vitejs/plugin-react'

export default defineConfig({
  plugins: [react()],
  build: {
    rollupOptions: {
      input: {
        main: resolve(__dirname, 'index.html'),
        options: resolve(__dirname, 'options.html')
      }
    }
  }
})
```

最终效果如下：

<video
  src="https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/options_zuppir.webm"
  autoPlay
></video>

## Source Code

[【Source Code】](https://github.com/rebelchris/popup-extension/tree/options)


基于react、tailwindcss开发自己的chrome插件

Chrome插件开发 - Custom options page


![xMzL6e](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/xMzL6e.jpg)

1. 安装`fontawesome`

```bash
npm install @fortawesome/fontawesome-svg-core @fortawesome/free-solid-svg-icons @fortawesome/react-fontawesome
```

2. 编辑`_app.js`

```js
import '@fortawesome/fontawesome-svg-core/styles.css' // import Font Awesome CSS
import {config} from '@fortawesome/fontawesome-svg-core'
config.autoAddCss = false // Tell Font Awesome to skip adding the CSS automatically since it's being imported above

const App = ({Component, pageProps}) => {
  return <Component {...pageProps} />
}

export default App
```

3. 在组件中使用`FontAwesomeIcon`

```js
// index.js

// Import the FontAwesomeIcon component
import {FontAwesomeIcon} from '@fortawesome/react-fontawesome'

// import the icons you need
import {
  faSearch,
  faAmbulance,
  faAnchor
} from '@fortawesome/free-solid-svg-icons'

const Home = (props) => {
  return (
    <div>
      <FontAwesomeIcon icon={faSearch} style={{fontSize: 100, color: 'blue'}} />

      <FontAwesomeIcon
        icon={faAmbulance}
        style={{fontSize: 100, color: 'orange'}}
      />

      <FontAwesomeIcon
        icon={faAnchor}
        style={{fontSize: 100, color: 'green'}}
      />
    </div>
  )
}

export default Home
```

4. 效果

![2kW3eL](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/2kW3eL.jpg)


Next.js是基于React的框架，具有服务器端渲染功能。

Next.js - Use Font Awesome with Next.js


![qxHyNO](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/qxHyNO.jpg)

JavaScript 是一种单线程的语言，意味着它只有一个调用栈和一个执行线程。当 JavaScript 执行一段代码时，它会按照代码的顺序将函数调用和表达式求值添加到调用栈中。调用栈是一种后进先出（LIFO）的数据结构，它保证了当前执行的代码是最后被添加到栈中的。

当 JavaScript 遇到异步代码时，它会将异步代码添加到任务队列中并继续执行后续代码。任务队列是一种先进先出（FIFO）的数据结构，它保证了先添加到队列中的任务会先被执行。

JavaScript 中的异步代码包括定时器、事件监听器、网络请求等。当这些异步操作完成时，它们会将回调函数添加到任务队列中。

当调用栈为空时，事件循环将从任务队列中取出一个任务并将其添加到调用栈中执行。当任务执行完成后，调用栈将被弹出，并且事件循环将继续从任务队列中取出下一个任务，直到任务队列为空。

在事件循环中，微任务队列是一种特殊类型的任务队列，它优先级高于任务队列。当任务队列中存在微任务时，事件循环将优先执行微任务队列中的任务，直到微任务队列为空。微任务包括 Promise 的回调函数和一些 DOM 操作的回调函数等。

当事件循环执行微任务时，它会一直执行微任务队列中的所有任务，直到微任务队列为空。然后它会继续从任务队列中取出下一个任务并执行，直到任务队列和微任务队列都为空。

事件循环包括以下几个主要概念：

- 调用栈（Call Stack）：调用栈是一种数据结构，它用于存储当前正在执行的函数调用的上下文信息。当一个函数被调用时，它的上下文信息被压入调用栈中，当函数执行完成时，它的上下文信息被从调用栈中弹出。
- 任务队列（Task Queue）：任务队列是一个队列，它用于存储待执行的任务。当一个任务被添加到任务队列中时，它会等待事件循环将它取出并执行。
- 事件循环（Event Loop）：事件循环是一个持续的过程，它不断地从任务队列中取出任务并执行它们。当调用栈为空时，事件循环将从任务队列中取出一个任务并将其压入调用栈中执行。
- 微任务队列（Microtask Queue）：微任务队列是一个队列，它用于存储微任务。微任务是一种特殊类型的任务，它会在当前任务执行完成后立即执行。微任务队列的优先级高于任务队列，这意味着当有微任务时，事件循环将先执行微任务队列中的所有任务，然后再执行任务队列中的任务。

事件循环的执行顺序如下：

- 当代码开始执行时，所有同步代码都会被按顺序添加到调用栈中执行。
- 如果遇到异步代码（例如定时器或事件监听器），则会将其添加到任务队列中并继续执行后续代码。
- 当调用栈为空时，事件循环将从任务队列中取出一个任务并将其压入调用栈中执行。
- 如果任务队列中有微任务，则事件循环将优先执行微任务队列中的所有任务，直到微任务队列为空。
- 重复执行步骤 3 和步骤 4，直到任务队列和微任务队列都为空


事件循环是每个前端开发必须理解的概念

事件循环


这篇文章学习创建一个插件用于改变每个页面的背景色

![aSYEyn](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/aSYEyn.jpg)

## 创建插件主体

浏览器插件的核心文件且必不可少的：manifest，它是个`json`文件，包含所有和插件相关的配置，必须放在根目录，其中`manifest_version`、`name`、`version`是必不可少的，`description`、`icons`是推荐的

以下是一些插件的配置项，供参考：

```json
{
  // 清单文件的版本，这个必须写，而且必须是2
  "manifest_version": 2,
  // 插件的名称
  "name": "demo",
  // 插件的版本
  "version": "1.0.0",
  // 插件描述
  "description": "简单的Chrome扩展demo",
  // 图标，一般偷懒全部用一个尺寸的也没问题
  "icons": {
    "16": "img/icon.png",
    "48": "img/icon.png",
    "128": "img/icon.png"
  },
  // 会一直常驻的后台JS或后台页面
  "background": {
    // 2种指定方式，如果指定JS，那么会自动生成一个背景页
    "page": "background.html"
    //"scripts": ["js/background.js"]
  },
  // 浏览器右上角图标设置，browser_action、page_action、app必须三选一
  "browser_action": {
    "default_icon": "img/icon.png",
    // 图标悬停时的标题，可选
    "default_title": "这是一个示例Chrome插件",
    "default_popup": "popup.html"
  },
  // 当某些特定页面打开才显示的图标
  /*"page_action":
 {
 "default_icon": "img/icon.png",
 "default_title": "我是pageAction",
 "default_popup": "popup.html"
 },*/
  // 需要直接注入页面的JS
  "content_scripts": [
    {
      //"matches": ["http://*/*", "https://*/*"],
      // "<all_urls>" 表示匹配所有地址
      "matches": ["<all_urls>"],
      // 多个JS按顺序注入
      "js": ["js/jquery-1.8.3.js", "js/content-script.js"],
      // JS的注入可以随便一点，但是CSS的注意就要千万小心了，因为一不小心就可能影响全局样式
      "css": ["css/custom.css"],
      // 代码注入的时间，可选值： "document_start", "document_end", or "document_idle"，最后一个表示页面空闲时，默认document_idle
      "run_at": "document_start"
    },
    // 这里仅仅是为了演示content-script可以配置多个规则
    {
      "matches": ["*://*/*.png", "*://*/*.jpg", "*://*/*.gif", "*://*/*.bmp"],
      "js": ["js/show-image-content-size.js"]
    }
  ],
  // 权限申请
  "permissions": [
    "contextMenus", // 右键菜单
    "tabs", // 标签
    "notifications", // 通知
    "webRequest", // web请求
    "webRequestBlocking",
    "storage", // 插件本地存储
    "http://*/*", // 可以通过executeScript或者insertCSS访问的网站
    "https://*/*" // 可以通过executeScript或者insertCSS访问的网站
  ],
  // 普通页面能够直接访问的插件资源列表，如果不设置是无法直接访问的
  "web_accessible_resources": ["js/inject.js"],
  // 插件主页，这个很重要，不要浪费了这个免费广告位
  "homepage_url": "https://www.baidu.com",
  // 覆盖浏览器默认页面
  "chrome_url_overrides": {
    // 覆盖浏览器默认的新标签页
    "newtab": "newtab.html"
  },
  // Chrome40以前的插件配置页写法
  "options_page": "options.html",
  // Chrome40以后的插件配置页写法，如果2个都写，新版Chrome只认后面这一个
  "options_ui": {
    "page": "options.html",
    // 添加一些默认的样式，推荐使用
    "chrome_style": true
  },
  // 向地址栏注册一个关键字以提供搜索建议，只能设置一个关键字
  "omnibox": {"keyword": "go"},
  // 默认语言
  "default_locale": "zh_CN",
  // devtools页面入口，注意只能指向一个HTML文件，不能是JS文件
  "devtools_page": "devtools.html"
}
```

现在让我们来创建插件的主体框架

1.创建目录

```bash
mkdir pinkify-extension && cd pinkify-extension
```

2.创建`manifest.json`

写入一些配置

```json
{
  "manifest_version": 3,
  "name": "Pinkify",
  "version": "1.0",
  "description": "Convert any page to a pinkish page 💖",
  "icons": {
    "48": "icons/pinkify-48.png"
  },
  "content_scripts": [
    {
      "matches": ["<all_urls>"],
      "js": ["pinkify.js"]
    }
  ]
}
```

3.创建`pinkify.js`

```
document.body.style.setProperty('background','#FDF2F7')
```

4.测试扩展

打开开发者工具，加载已解压的扩展程序，选择`pinkify-extension`目录即可。

![FwLxRT](https://cdn.jsdelivr.net/gh/manonicu/pics@master/uPic/FwLxRT.jpg)
