本文是基于微信小程序官网及网上的一些文章做的总结， 一些内容比较抽象主要用于复习巩固，对于没有小程序开发经验的同学还是推荐先阅读小程序官方文档，写写案例。



# 背景
> - 2016年，应用号 -> 小程序，1月张小龙提出应用号，11月微信小程序开发公测
> - 2017年，1月微信小程序正式发布
> - 2018年，1月大量企业、开发者、资本、运营入场；3月，十家手机厂商推出快应用；9月支付宝小程序正式上线、百度小程序入场、头条小程序入场，10月抖音小程序入场
> - 2022年，微信小程序日活用户超5亿

# 微信小程序架构
- 双线程模型 逻辑层和渲染层是分开的
- 使用类似于微信 JSSDK 这样的 Hybrid 技术（即界面主要由成熟的 Web 技术渲染，辅之以大量的接口提供丰富的客户端原生能力）。

## 微信已经有了公众号生态为什么还要造个小程序生态
公众号模式有哪些问题？
- 如果任由a标签可以任意跳转 （跳到哪里微信不知道，跳出去的网站可能涉及安全问题）
- js可以操作dom，如触发点击事件，可能在用户不知情的情况下获取了用户的隐私。
- 任由ajax随便请求，存在CSRF攻击的风险，在微信生态下的问题，也会给微信带来一些商誉影响
- eval、Function 等可能引发 XSS 
- 自己造轮子除了更强的把控商家用户的行为，也给用户带来更好的体验，如使用微信or原生api的能力。
- 国家监控，国家会对微信提出一些整改要求，微信需要从技术层面限制把控商户的行为
- 。。。

根本原因： 
- 公众号模式还是一个web应用模式，web讲究开放互联，对于web应用来说微信的感知能力要差很多。
- 微信则是需要更加强有利的技术去感知商户及用户行为、管控商家、服务用户，增加用户黏性，获取更多的流量，塑造微信生态（形成超级APP），最后实现自己的商业壁垒。

直接原因：
- 为了**管控与安全**的需要同时兼顾了性能。关于管控与安全，对内来说微信自身有这个诉求，对外国家对它也有这个诉求。

## 为什么采用Hybrid技术
> 首先介绍下三种UI渲染技术
> 1. Native原生渲染：流畅可访问系统api 高留存；高成本、更新体验差
> 2. Web技术渲染：成本低、跨平台；无法使用系统功能、低留存
> 3. Hybrid混合渲染、web+native   （`cordova`、`h5+`）

采用Hybrid技术有一下优势
- 快速加载（本地加载资源+离线使用）体验优于web 接近原生体验
- 提供移动端的能力以及自己的能力
- 简单高效的开发及发布（web可以灵活发版，原生不能）

## 双线程模型
首先了解下双线程模型

![image.png](https://blog.warmplace.cn/static/img/a4471ff266ae31400993ad5ddd5b4936.image.webp)

- 小程序的视图层和逻辑层分别由两个线程管理：视图层的界面使用Webview进行渲染；逻辑层采用JSCore运行JavaScript代码
- 一个小程序有一个逻辑层（方便逻辑状态共享），视图层有多个webview (主要是性能原因，DOM简单，页面切换也快)
- 两个线程间的通信则由 JSBridge 中转
   - iOS 是利用了WKWebView 的提供 messageHandlers 特性，
   - 而在安卓则是往 WebView 的 window 对象注入一个原生方法，最终会封装成 WeiXinJSBridge 这样一个兼容层，主要提供了调用（invoke）和监听（on）这两种方法。
- 使用双线程也是从管控与安全的角度考虑的，
   - 避免JS操作DOM
   - 提供一个沙箱环境来运行开发者的JavaScript 代码

![image.png](https://blog.warmplace.cn/static/img/a58fae8e23eb9ca9bcaaf8d864759ed6.image.webp)

- 双线程缺点 ：  **天生的延时**

## 为什么要采用双线程？
> - 为什么不使用浏览器线程模型？
> - 为什么不使用 Web Worker？

不使用浏览器线程模型主要有两个原因

1. 前面提到的管控与安全
2. 浏览器JS 是单线程的，JS执行阻塞dom渲染，dom渲染阻塞JS

不使用WebWorker的原因 

- worker本身非常耗资源，除了计算资源消耗还有和主线程通信的损耗也很严重；小程序逻辑层和试图层是同级线程性能相对可靠
- web worker 限制也很多，不能跨域，双线程安全

## 小程序的运行机制

1. 启动

![image.png](https://blog.warmplace.cn/static/img/4081a9323b6a890508bd7b00c19c2c46.image.webp)

2. 更新机制

![image.png](https://blog.warmplace.cn/static/img/9d8f1125f9a4dd7f1a584ff050a6dc6d.image.webp)

## 小程序生命周期

![image.png](https://blog.warmplace.cn/static/img/478e4731d69c6bf4957488123c4f1696.image.webp)

## 组件系统
也是从安全管控的要求考虑，不直接提供HTML的能力（如你不能使用`<a>`标签任意跳转）；
微信设计一套组件框架——`Exparser`。基于这个框架，内置了一套组件，以涵盖小程序的基础功能，便于开发者快速搭建出任何界面。同时也提供了自定义组件的能力，开发者可以自行扩展更多的组件，以实现代码复用。

### Exparser框架
Exparser的组件模型与WebComponents标准中的ShadowDOM高度相似。

### 内置组件
定义内置组件的原则： **没有这个组件的话，在小程序架构里无法实现或者实现不好某类功能**。

- `open-data`组件提供展示群名称、用户信息
- `button`组件里`open-type`属性

### 自定义组件

- 运行原理
- 组件间通信
   - `WXML`属性值传递&emsp;父到子
   - 事件系统&emsp;子到父
   - `selectComponent`&emsp;相当于`vue`的`$ref`
   - `relations`&emsp;类似`vue`的`provide`/`inject`

# 小程序核心语法
## 基本项目目录
- `pages`  页面目录
   - index  首页目录
      - index.js/json/wxml/wxss  首页逻辑、配置、模板、样式
- `app.js`  全局入口文件
- `app.json`   全局配置文件
- `app.wxss`   全局样式文件
- `project.config.json`   项目配置文件
- `sitemap.json`   微信索引配置文件

## 基本配置
- 全局配置
- 页面配置
- 索引地图配置

## 全局对象
- 不管是逻辑层还是试图层，微信都做了一个沙盒环境
   - 逻辑层没有`window`、`document`等浏览器对象
- 通过`wx`对象，提供一些移动端的能力及微信自身的能力
- `App Service`
   - `App()`  注册程序
   - `Page()`  注册页面
   - `getApp()`  获取 APP 实例
   - `getCurrentPages()`  获取当前页面栈
   - `API`  `wx.xxx()`
   - 模块化能力

## 常见API
- 路由
   - `wx.navigateTo` / `redirectTo`、`wx.switchTab` / `reLaunch`、`wx.navigateBack`  路由跳转
- 界面
   - `wx.showToast` / `showLoading` / `showModal`  显示消息提示、加载提示、模态窗
- 网络
   - `wx.request` / `downloadFile` / `uploadFile`  网络请求、文件下载、文件上传
- 数据缓存
   - `wx.setStorage` / `getStorage`   缓存数据存取
- 开放接口
   - `wx.login` / `authorize` / `getUserInfo`  登录、授权、获取用户信息
- WXML
   - `wx.createSelectorQuery`   获取节点信息

## 视图层
> - WXML (WeiXin Markup lauguage)：描述页面结构
> - WXSS (WeiXin Style Sheet)：描述页面样式
> - WXS (WeiXin Script)：小程序脚本语言

### WXML
- 数据绑定：`wxml` 动态数据来自 `Page` 中的 `data`
- 语法规则：`Mustache` 语法 `{{ }}`  为运算标记，内部为表达式
- 控制属性：`wx:if` / `wx:for` / `model:value`
- [模板](https://developers.weixin.qq.com/miniprogram/dev/reference/wxml/template.html)
- [引用](https://developers.weixin.qq.com/miniprogram/dev/reference/wxml/import.html)
   - `<import>` 引入目标文件的 `template` 模板
   - `<include>` 引入目标文件除 `template` 与 `wxs` 以外代码（相当于代码直接拷贝到该标签位置）

### WXSS
- 可使用绝大多数 CSS 特性
- 扩展
   - 尺寸单位 `rpx` (responsive pixel)
      - iPhone6 / 375px /750 物理像素  ——  1px = 2rpx
   - 样式导入  `@import`
      - @import “common.wxss”

### WXS
- 优点：一定程度上可以缓解跨线程通信的开销
   - 非纯 JS 语法、不支持 ES6
   - 不能调用其他 JS 文件函数、不能使用小程序 API
   - 不能作为自定义组件的事件回调
- 使用场景：过滤器、拖拽（频繁通信）

## 事件系统
- 事件：用户行为反馈到逻辑层处理
- 事件绑定 （与h5相比，不支持条件编程，如虚拟滚动的实现）
   - `bind:[eventName]`&emsp;&emsp;&emsp;&emsp;&emsp;冒泡事件
   - `capture-bind:[eventName]`&emsp;捕获事件
   - `catch:[eventName]`&emsp;&emsp;&emsp;&emsp;&emsp;冒泡事件（阻止事件继续冒泡）
   - `capture-catch:[eventName]`&emsp;捕获事件（阻止事件继续捕获、冒泡）
   - `mut-bind:[eventName]`&emsp;&emsp;&emsp;互斥事件
- 绑定数据
   - `data-[dataName]` 

## 基础组件
- 内置组件：`view`、`text`、`image`、`button`、`icon`、`web-view…`
- 原生组件（同层渲染技术）：`textarea`、`video`、`canvas`、`map`、`camera`、`live-player/pusher`、`input`
- 自定义组件

### 同层渲染原理
- 同层渲染：通过一定技术手段，使原生组件直接在`WebView`层渲染
   - iOS：基于 `WKWebView` 的原生组件 `WKChildScrollView`
      - 创建 `DOM` 节点并设置 `overflow: scroll`（内核创建 WKChildScrollView）
      - 微信端找到 DOM 节点对应的 `WKChildScrollView`
      - 将原生组件挂载到对应 `WKChildScrollView` 容器
   - Android：基于 `Chromium` 的 `WebPlugin` 插件机制
      - 创建 `<embed>` DOM 节点并指定组件类型（内核创建 `WebPlugin` 实例，生成 `RenderLayer`）
      - 将原生组件绘制到 `RenderLayer` 绑定的 `SurfaceTexture`
      - 通知 `Chromium` 渲染该 `RenderLayer`、渲染 `embed` 节点

# 性能优化
## 合理使用setData
- 只包括渲染相关的数据
- 控制`setData`频率  `nextTick`策略
- 差量更新  `this.setData({'obj.list.0.name':'差量更新'})`
- 避免在切后台后仍进行高频的 setData，例如倒计时更新

## 渲染性能优化
- 滚动相关推荐优先使用滚动驱动动画或者`wxs`
- 使用`IntersectionObserver`监听元素曝光
- 控制`WXML`数量和层级

## 页面切换优化
- 减少或避免在 `onHide`/`onUnload` 中执行耗时逻辑，如同步接口调用、`setData`等

## 资源加载优化
- 控制图片资源的大小
- 预先给定图片的尺寸 预渲染优化

## 内存优化
- 合理使用分包，  
- 按需注入，用时注入
- 垃圾回收方面 事件监听要移除、清理定时器

# 从web开发者角度去看小程序开发
## 对比小程序原生开发与h5原生开发
1. 文件名称三端到四段
2. 标签名称
   1. 精简了
   2. 新增一些与移动端的组件
   3. `cover-view` [可覆盖原生组件的视图容器](https://uniapp.dcloud.io/component/cover-view?id=cover-view) `cover-view`需要多强调几句，`uni-app`的非h5端的`video`、`map`、`canvas`、`textarea`是原生组件
3. js方面
   1. 都遵从`ecma`规范，标准`js`语法和`api`都支持 ，运行环境从浏览器变成`v8`引擎
   2. 然而浏览器下的JS，如`DOM`、`BOM`没有了
   3. 以前的**dom**操作，改成**MVVM**模式
   4. `js api` 发生变更 
      1. `alert`/`comfirm`  ==> `wx.showModel`
      2. `ajax` ==>  `wx.request`
      3. `cookie`/`session`没有了   用`localStorage`实现
4. css方面
   1. 通用选择器 没有了  `body` ==> `body`
   2. 单位 `rpx`
   3. 推荐使用`flex`
   4. css里背景图和字体文件 不能>40Kb 超过这个只要用base64或者外链
5. 工程结构和页面管理
   1. h5工程化开发者自由实现，
   2. 小程序通过配置app.json管理页面、分包、tabbar、导航相关配置，
   3. 组件也是在json文件中配置

## 对比小程序开发与vue开发
1. 生命周期   口述
2. 模版语法
   1. 小程序的数据绑定参考了vue，但自己修改了一些。在uni-app中只支持标准的vue，不支持小程序的数据绑定语法(bindinput解决)
   2. 数据绑定 列表渲染 显示和隐藏
3. 事件
   1. 写法
   2. 传值
4. 响应式
   1. 小程序里的`setData`在`uni-app`里并不存在，因为`vue`是自动双向数据绑定的。直接通过赋值方式修改数据，如果数据绑定到界面上，界面会自动更新渲染
      1. 取值`this.data.reason`
5. 组件通信
   1. 注册使用组件
   2. 父子组件通信  类似`vue`
      1. 子组件通知父组件 `triggerEvent`
      2. 父组件调用子组件 `$ref`
      3. 子组件样式 通过`props`传递或控制子组件样式  或者子组件类名前面加上父组件类名

## 对比uniapp开发与小程序开发异同点
1. 跨端开发 各端小程序、`h5`、`app`、快应用
2. 条件编译 开放包容
3. `uni-app`推荐使用`flex`布局，这个布局思路和传统流式布局有点区别。但`flex`的特色在于，不管是什么技术都支持这种排版，`web`、小程序/快应用、`weex`/`rn`、原生的`iOS`、`Android`开发，全都支持`flex`。它是通吃所有端的新一代布局方案。
4. 小程序的`app.json`被分成两段 `page.json`、`mainfest.json`
5. 原来的`app.js`和`app.wxss`被合并到了`app.vue`中

参考资料
[白话uni-app 【也是html、vue、小程序的区别】](https://ask.dcloud.net.cn/article/35657)
[vue和微信小程序的区别、比较](https://segmentfault.com/a/1190000015684864)

# 微信小程序开发调试相关问题
- 开发版 需要在微信小程序后台 添加为开发者才能进入，给开发着使用，能进行真机调试
- 体验版 需要在小程序后台添加为项目成员，主要给测试、产品人员使用，
   - 同一个小程序体验版二维码永远不会变，可从微信小程序助手进入
   - 如果当前体验版是A上传的，A再次上传，体验版自动更新，如果是B上传，则需要在小程序后台切一下体验版
- 生产版本， 对外开放，可以通过微信搜索找到
- 真机调试
   - 微信扫码真机调试， 会新开一个干净的容器（无网络缓存、授权信息、数据缓存等）
   - 关闭真机调试，微信会留下一个开发版
   - 真机调试的开发版与开发着工具中的版本是相互隔离的
- 开发版、体验版、生产版 共用同一个storage
- [VConsole](https://developers.weixin.qq.com/miniprogram/dev/framework/usability/vConsole.html) 
   - 开发版或体验版 打开调试 重启小程序后会有一个VConsole 

1. 简述小程序双线程模型
2. 小程序与h5的区别
3. 原生小程序与其他框架对比
4. 小程序如何优化性能

参考资料：
- [微信小程序官网](https://developers.weixin.qq.com/miniprogram/dev/framework/)
- 七冥老师的博客
- [uniapp官网的一些资料](https://uniapp.dcloud.io/resource.html)
- [匠心博客](https://zhaomenghuan.js.org/blog/wechat-miniprogram-principle-analysis.html)

微信小程序学习笔记

React源码学习

本文介绍不可变数据类型`ImmutableJS`和`ImmerJS`的基本用法，以及它们在React项目中的使用。



# 背景： 为什会有immutable?
> 在JavaScript中有引用类型和基本类型。
> - 如果 变量a是基本类型，将a赋值给变量b，再修改b的值，则变量a不受影响
> - 如果 变量a是引用类型，将a赋值给变量b， 则b与a是同一个对象的引用，若修改b对象的属性，a对象的该属性也会跟着变化。<br><br>
> 解决方案就是深拷贝，比如最简单的方式`JSON.parse(JSON.stringify(obj))`。
> - 但是深拷贝这种方式比较耗费性能（空间和时间），有没有折中的方案呢？ 即修改b的同时不影响a，且比深拷贝节省性能。
> - 所以有了immutable.js，简单说就是按需深拷贝。
> - 此外还有一个重要原因，开发中经常遇到函数带有副作用，副作用的函数修改了一个引用类型某个属性的值或者浅copy的问题，immutable为此类问题提供了一种优雅的解决方案。

# 什么是immutable?

- `Immutable Data` 就是一旦创建，就不能再被更改的数据
- 对 `Immutable` 对象的任何修改或添加删除操作都会返回一个新的 `Immutable` 对象；
- `Immutable` 实现的原理是 `Persistent Data Structure`（**持久化数据结构**）：**也就是使用旧数据创建新数据时，要保证旧数据同时可用且不变**。同时为了避免 `deepCopy` 把所有节点都复制一遍带来的性能损耗，`Immutable` 使用了 `Structural Sharing`（**结构共享**），即如果对象树中一个节点发生变化，只修改这个节点和受它影响的父节点，其它节点则进行共享。

<img src='https://blog.warmplace.cn/static/img/2b4c801a7b40eefcd4ee6767fb984fdf.a.gif' width=400>

# immutable.js
`immutable`是Javascript中不可变的集合<br />[官网](https://immutable-js.com/)

Facebook 工程师 `Lee Byron` 花费 3 年时间打造，与 React 同期出现，但没有被默认放到 React 工具集里（React 提供了简化的 Helper）。它内部实现了一套完整的 `Persistent Data Structure`，还有很多易用的数据类型。像 `Collection、List`、`Map`、`Set`、`Record`、`Seq`。有非常全面的`map`、`filter`、`groupBy`、`reduce`、`find`函数式操作方法。同时 `API` 也尽量与 `Object` 或 `Array` 类似。
```javascript
// 原来的写法
let foo = {a: {b: 1}};
let bar = foo;
bar.a.b = 2;
console.log(foo.a.b);  // 打印 2
console.log(foo === bar);  //  打印 true

// 使用 immutable.js 后
import Immutable from 'immutable';
var foo = Immutable.fromJS({a: {b: 1}});
var bar = foo.setIn(['a', 'b'], 2);   // 使用 setIn 赋值
console.log(foo.getIn(['a', 'b']));  // 使用 getIn 取值，打印 1
// 等价于 foo.getIn(['a']).getIn(['b'])
console.log(foo === bar);  //  打印 false
```
# 快速入门API
笔者没有找关于immutable相关能够通俗易懂快速上手的中文文档，无奈只能自己阅读官方文档，以下内容是笔者基于官方文档整理的自己的总结
```javascript
// 前面提到为了消除引用类型及浅拷贝的副作用，引入了immutable概念
// 但是深拷贝这种方式比较耗费性能
// 因此寻找一种既能避免副作用又节省开销的方式--结构共享
// 没有immutable.js我们可能采用下面的方式避免副作用
var a = {b:'B',c:{d:1}};

var b = Object.assign({}, a);
b.b = 'new val bbb';

console.log(b.b)	// 'new val bbb'
console.log(a.b); // 仍旧为 'B'
console.log(a.c === b.c); // true

// 显然 7，8行代码书写起来不方面，
// 如果a.b也是引用类型，还对a.b 重复进行上述两部操作
```
然而 `immutable.js` 的使用有一定的上手成本，它自定义了一些数据结构
## Map类型
```javascript
// 如果是对象类型，在immutable中使用 Map
const { Map } = require('immutable');
const map1 = Map({ a: 1, b: 2, c: [1,2] });
// 修改原对象的属性会产生一个新对象， 原对象保持不变
const map2 = map1.set('b', 50); 

// 使用 .equals 方法比较
console.log(map1.equals(map2)); // false
// 取值 .get
console.log(map1.get('b'), map2.get('b')); // 2, 50
console.log(map1.get('c') === map2.get('c')); // true， c没有改变
```

## 不可变类型比较
引用类型的比较是基于引用地址，而不可变对象的比较是基于集合的值是否一一相同
```javascript
const { Map } = require('immutable');
const map1 = Map({ a: 1, b: 2, c: 3 });
const map2 = Map({ a: 1, b: 2, c: 3 });
map1.equals(map2); // true 
// Immutable.is(map1, map2); // true
map1 === map2; // false

const map3 = map2.set('b', 2);
map3 === map2; // true

// 如果一个对象是不可变的，
// 则可以简单地通过对它进行另一个引用而不是复制整个对象来“复制”它。
// 因为这可以节省内存并潜在地提高依赖副本的程序的执行速度（例如撤消堆栈）。
```
补充： 不可变对象的比较是基于值，算法复杂度$O(N)$, 而引用类型比较算法复杂度 $O(1)$ , 因此使用时要考虑性能权衡。

## JavaScript优先的API
Immutable.js 具有一个与 ES2015 Array、Map 和 Set 非常相似的面向对象的 API。

| JavaScript | immutable |
| --- | --- |
| Map | Map |
| Set | Set |
| Array | List |
| Object | fromJS or Map |

```javascript
const { Map, List } = require('immutable');
const map1 = Map({ a: 1, b: 2, c: 3, d: 4 });
const map2 = Map({ c: 10, a: 20, t: 30 });
const obj = { d: 100, o: 200, g: 300 };
const map3 = map1.merge(map2, obj);
// Map { a: 20, b: 2, c: 10, d: 100, t: 30, o: 200, g: 300 }
const list1 = List([1, 2, 3]);
const list2 = List([4, 5, 6]);
const array = [7, 8, 9];
const list3 = list1.concat(list2, array);

// 从上面的示例可以看出 
// 1. 与JS API靠拢 如 Array.prototype.concat
// 2. api可以与JS对象互相操作


// 所有 Immutable.js 集合都是可迭代的
const { List } = require('immutable');
const aList = List([1, 2, 3]);
const anArray = [0, ...aList, 4, 5]; // [ 0, 1, 2, 3, 4, 5 ]
```
## 嵌套结构
```javascript
// 嵌套结构
const { fromJS } = require('immutable');
const nested = fromJS({ a: { b: { c: [3, 4, 5] } } });
console.log(typeof nested.toJS()); // 'object'


const nested2 = nested.mergeDeep({ a: { b: { d: 6 } } });
// nested2  { a: { b: { c: [3, 4, 5] }, d: 6 } }

console.log(nested2.getIn(['a', 'b', 'd'])); // 6
console.log(nested2.getIn(['a']).getIn(['b', 'd'])); // 6

const nested3 = nested2.updateIn(['a', 'b', 'd'], value => value + 1);
console.log(nested3);
// Map { a: Map { b: Map { c: List [ 3, 4, 5 ], d: 7 } } }

const nested4 = nested3.updateIn(['a', 'b', 'c'], list => list.push(6));
// Map { a: Map { b: Map { c: List [ 3, 4, 5, 6 ], d: 7 } } }
```
## 批处理突变
默认情况下`immutable.js`中的`api`每执行一次就会返回一个新的`immutable`对象<br />
那么如果我只需要最后生成的`immutable`对象，中间的对象都不要，可不可以只返回新一个新对象呢？<br />
这就用到了 `withMutations` ，批量处理节省开销，目前只有少数方法 `set`、`push`、`pop` 可直接应用于持久化数据结构
```javascript
const { List } = require('immutable');
const list1 = List([1, 2, 3]);
const list2 = list1.withMutations(function (list) {
  list.push(4).push(5).push(6);
});
console.log(list1.size); // 3
console.log(list2.size); // 6
```

## 惰性序列
```javascript
const { Seq } = require('immutable');
const oddSquares = Seq([1, 2, 3, 4, 5, 6, 7, 8])
  .filter(x => {
      console.log('filter', x)
    return x % 2 !== 0
  })
  .map(x => x * x);
// 因为oddSquares是一个immutable对象，是惰性执行的，上述代码不会做任何操作

// 当把immutable对象转换成 JavaScript 对象是 才会执行
console.log(oddSquares.toJS()); // 控制台打印了 ‘filter’


// Range 是一种特殊的 Lazy 序列。
const { Range } = require('immutable');
const a = Range(990, 1010)
//   .skip(100)
  .map(n => {
      console.log(n)
      return -n;
  })
  .reduce((r, n) => r * n, 1);

console.log('---', a) // --- 9.897178826145609e+59
```

## cursor
由于 Immutable 数据一般嵌套非常深，为了便于访问深层数据，Cursor 提供了可以直接访问这个深层数据的引用。
```javascript
import Immutable from 'immutable';
import Cursor from 'immutable/contrib/cursor';

let data = Immutable.fromJS({ a: { b: { c: 1 } } });
// 让 cursor 指向 { c: 1 }
let cursor = Cursor.from(data, ['a', 'b'], newData => {
  // 当 cursor 或其子 cursor 执行 update 时调用
  console.log(newData);
});

cursor.get('c'); // 1
cursor = cursor.update('c', x => x + 1);
cursor.get('c'); // 2
```
## 优点
1. 降低了mutable带来的复杂性
```javascript
function touchAndLog(touchFn) {
  let data = { key: 'value' };
  touchFn(data);
  console.log(data.key);
  // 因为不知道touchFn进行了什么操作，所以无法预料，但使用immutable，肯定是value
}
```

2. 节省内存
会尽量复用内存，甚至以前使用的对象也可以再次被复用。没有被引用的对象会被垃圾回收。
```javascript
import { Map} from 'immutable';
let a = Map({
  select: 'users',
  filter: Map({ name: 'Cam' })
})
let b = a.set('select', 'people');

a === b; // false
a.get('filter') === b.get('filter'); // true
```

3. `Undo/Redo`，`Copy/Paste`<br />
因为每次数据都是不一样的，所有可以存储在数组里，想回退到哪里就拿出对应数据即可

## 缺点
1. 需要学习新的API
2. 容易与原生对象混淆
   1. 虽然 `Immutable.js` 尽量尝试把 `API` 设计的原生对象类似，有的时候还是很难区别到底是 `Immutable` 对象还是原生对象，容易混淆操作。
   2. `Immutable` 中的 `Map` 和 `List` 虽对应原生 `Object` 和 `Array`，但操作非常不同，比如你要用 `map.get('key')` 而不是 `map.key`，`array.get(0)` 而不是 `array[0]`。另外 `Immutable` 每次修改都会返回新对象，也很容易忘记赋值；
   3. 当使用外部库的时候，一般需要使用原生对象，也很容易忘记转换。

下面给出一些办法来避免类似问题发生：

1. 使用`TypeScript` 这类有静态类型检查的工具；
2. 约定变量命名规则：如所有 `Immutable` 类型对象以 `$$` 开头；
3. 使用 `Immutable.fromJS` 而不是 `Immutable.Map` 或 `Immutable.List` 来创建对象，这样可以避免 `Immutable` 和原生对象间的混用；

## 使用immutable.js优化react
1. React可以使用 `shouldComponentUpdate()`进行性能优化，但它默认返回 `true`，即始终会执行 `render()` 方法，然后做 `Virtual DOM` 比较，并得出是否需要做真实 `DOM` 更新；
2. 可以在`shouldComponentUpdate` 周期里执行`deepCopy` 和 `deepCompare` 避免无意义的`render`，但`deepFn`也很耗时；
```javascript
import { is } from 'immutable';
shouldComponentUpdate: (nextProps = {}, nextState = {}) => {
  const thisProps = this.props || {}, thisState = this.state || {};

  if (Object.keys(thisProps).length !== Object.keys(nextProps).length ||
      Object.keys(thisState).length !== Object.keys(nextState).length) {
    return true;
  }

  for (const key in nextProps) {
    if (!is(thisProps[key], nextProps[key])) {
      return true;
    }
  }

  for (const key in nextState) {
    if (thisState[key] !== nextState[key] && !is(thisState[key], nextState[key])) {
      return true;
    }
  }
  return false;
}
```

# immer
[官方文档](https://immerjs.github.io/immer/zh-CN/)

对于处理修改引用类型副作用问题，ImmutableJS 有两个较大的不足：
1. 需要使用者学习它的数据结构操作方式，没有 Immer 提供的使用原生对象的操作方式简单、易用；
2. 它的操作结果需要通过toJS方法才能得到原生对象，这使得在操作一个对象的时候，时刻要知道操作的是原生对象还是 ImmutableJS 的返回结果，稍不注意，就会产生问题；
```javascript
let currentState = {
    x:[2]
}
  
let o1 = currentState;
o1.a = 1;
  
let o2 = {
    ...currentState
};
o2.x.push(3); 
console.log(currentState) // { x: [ 2, 3 ], a: 1 }


/* 使用immer解决上述问题 */
import produce from 'immer';
let state = {
    x:[2]
}
let obj1 = produce(state, draft => {
  draft.a = 1;
});
let obj2 = produce(state, draft => {
    draft.x.push(3);
});
// { x: [ 2 ] }     { x: [ 2 ], a: 1 }      { x: [ 2, 3 ] }
console.log(state, obj1, obj2);

// produce方法做了哪些事情？
// 遍历原始对象，依次冻各个属性。
```
## 概念说明
`produce(currentState, recipe: (draftState) => void | draftState, ?PatchListener): nextState`

- `currentState`：被操作对象的最初状态
- `draftState`：根据 `currentState` 生成的草稿状态，它是 `currentState` 的代理，对 `draftState` 所做的任何修改都将被记录并用于生成 `nextState` 。在此过程中，`currentState` 将不受影响
- `nextState`：根据 `draftState` 生成的最终状态
- `produce`：用来生成 `nextState` 或 `producer` 的函数
- `producer`：通过 `produce` 生成，用来生产 `nextState` ，每次执行相同的操作
- `recipe`：用来操作 `draftState` 的函数

## 使用immer优化react
```javascript
// 原写法 setState
const { members } = this.state;
this.setState({
  members: [
    {
      ...members[0],
      age: members[0].age + 1,
    },
    ...members.slice(1),
  ]
})

// 现在写法 
const { members } = this.state;
this.setState(this.setState(produce(members, draft => {
  draft.members[0].age++;
})))
```
## reduce中使用immer
```javascript
// produce 内的 recipe 回调函数的第2个参数与obj对象是指向同一块内存
function reducer (state = {name: '章三', age: 12}, action) {
    return immer.produce(state, (draft) => {
        switch(action.type) {
            case 'ADD':
                draft.age++;
                return
            default: 
                return;
        }
    })
}

const store = Redux.createStore(reducer);
class App extends React.Component {
    componentDidMount() {
        store.subscribe(() => {
            this.forceUpdate();
        })
    }
    render() {
        const state = store.getState();
        return <div>
            <p>{state.name}今年{state.age}周岁</p>
            <button onClick={() => store.dispatch({type: 'ADD'})}>过生日</button>
        </div>
    }
}
const root = ReactDOM.createRoot(document.getElementById('root'));
root.render(<App/>);
```
完整案例  [redux-immer.html](https://github.com/guojingwen/frontend-project/blob/main/react_study/6.immutable_immer/3.redux-immer.html)

Immutable、Immer不可变数据类型

个人学习笔记，按照官方案例自己跑了一遍`react-router`。通过类比`vue-router` 写了一些总结， 所以不是很推荐阅读。 建议读者也跟着官方案例走一遍。


# 简介
[官方文档](https://reactrouter.com/en/main)

- `react-router`包含3个库，`react-router`、`react-router-dom`和`react-router-native`。
- `react-router-dom`(浏览器) 和 `react-router-native`（RN） 都依赖`react-router`，所以在安装时，`react-router`也会⾃动安装。
- `react-router-dom` v6与v5发生了不兼容性的变更
   - v5版本奉行**⼀切皆组件的思想。**路由器-Router、链接-Link、路由-Route、独占-Switch、重定向-Redirect都以组件形式存在
   - v6 对v5做了些不兼容的变更，还提供了类似vue-router配置化的方式
   - `react-router`官方文档老是提到[@reach/router](https://reach.tech/router/) 后者v2版本已经合并到了`react-router@6`

# 快速入门
推荐看这篇：[**官方教程*一个通讯录的增删改查的小应用**](https://github.com/remix-run/react-router/blob/main/docs/start/tutorial.md)，我按照官方教程自己撸了一遍，[**代码点击这里**](https://github.com/guojingwen/frontend-project/tree/main/react_study/7.router-office-v6)，这里简单做一些总结，加强一下记忆，由于本人多年来都是使用`Vue`搬砖，掌握`react-router`最快的方式是类比`vue-router`

1. 先来看一下框架
![image.png](https://blog.warmplace.cn/static/img/9ceaa9b8416aff7121c2a903d6b9c100.image.webp)

- `vue-router` 3与4 的语法糖的异同
    - 引入时有些差异，里层路由的配置基本一样
    - 版本4 提供了两个钩子`useRoute`和`useRouter`等价于`this.$route`和 `this.$router`
    - 版本4 完全可以使用`OptionsAPI`
- `react-router`最新版本是6，本文主要是探讨6版本的语法糖，最后在补充一些`react-router`@6与5版本的区别。

2. 再来看一下内核配置，我们来写一个嵌套路由和动态路由的示例
![image.png](https://blog.warmplace.cn/static/img/7fc5ae1cda6153a8afc8e410dbc1a194.image.webp)
- `react-router` 的`element` 对应 `vue-router`的`compoent`
- 嵌套路由, `vue`还需要在父路由页面模板中放置`<router-view/>`
- 动态路由，`vue`通过 `$route.params` or `useRoute()`取值，`react`这边还需要配置`loader({params})`，通过`params`取值
- `loader`除获取路由参数，还可以做一些额外的事情，`vue-router`中没有`loader`的概念，可以用`beforeMout`或`create`模拟实现，然而`vue-router`中的`meta`字段，`react-router`也是要模拟

3. 再来看一下错误页面(也就404页面)的示例

![image.png](https://blog.warmplace.cn/static/img/fa312773c55ea09396930e9dbac8ea26.image.webp)

- `react-router`中只要遇到错误就渲染`errorElement`，vue中需要模拟实现，1）模拟不存在的路由，2）使用 `try...catch` 或 `errorHandler` 捕捉错误然后重定向到错误页面或渲染错误组件
- 默认页面 
   - `react-router` `{ index: true, element: <Index/> },`
   - `vue-router` 使用 `v-if`/`v-else` + `<router-view/>`方式模拟
4. `Form` 和 `action`  
   - 用于路由跳转和动作派发，可类比 vue的API跳转和路由守卫，
   - `react-router`把一些`form`的事情（表单提交、搜索）和路由做了挂钩，并提供了一些组件和钩子
- 组件有 `Form`、`NavLink`、`Outlet`
- 钩子 `useLoaderData`、`useFetcher`
> 在Vue中有路由守卫的概念:
> 1. 导航被触发
> 2. 在失活组件调用beforeRouteLeave守卫
> 3. 调用全局的beforeEach守卫
> 4. 再重用的组件调用beforeRouteUpdate
> 5. 在路由配置里调用beforeEnter
> 6. 解析异步路由组件
> 7. 在激活的组件中调用beforeRouteEnter
> 8. 调用全局的beforeResolve
> 9. 导航被确认
> 10. 调用全局的afterEach钩子
> 11. 触发DOM更新
> 12. 调用beforeRouteEnter守卫中传给next的回调函数

`react-router`没有路由守卫的概念，`loader+action`可以模拟这些行为

5. 其它一些可以对标的点 `react-touter`   	`vs` 	`vue-router`
   - `<Outlet/>`				-				`<router-view>`	
   - `<NavLink/>`				-				`<router-link>`
   - `redirect`				-				`$router.replace` 或路由表里配置 `redirect`
   - `useNavigation`			- 				`$router.go`、`$router.push`
   - `submit`					- 				`$router.replace `、`$router.push`
   
# JSX Routes 与 options Routes

![image.png](https://blog.warmplace.cn/static/img/7c2b94153692c8a6b5038f7f66957028.image.webp)

# React-router@5升级到6
[官方文档](https://github.com/remix-run/react-router/blob/main/docs/upgrading/v5.md)

React理念