联系作者
联系作者

# 8.1 真机远程代码调试

# 8.1.1 ios真机设备调试

  1. 在手机是上开启网页检查器

设置-> safari 浏览器 -> 高级 -> 网页检测器

  1. 开启Safari上的Develop功能

菜单 -> Preferences(偏好设置) -> Advanced(高级)

  1. 使用数据线连接手机个开发主机
  • 信任电脑
  1. 打开devTool

Develop -> 你的ios设备 -> 要调试的页面

# 8.1.2 Android真机设备调试

  1. 在手机上开启USB调试功能

设置-> 开发者选项 -> USB调试

  1. 使用数据线连接手机和开发主机
  • 允许USB调试
  1. 打开Chrome DevTools
  • 在地址栏输入chrome://inspect
  • 确保开启了 Discover USB devices

# 8.2 无线调试工具-Weinre

  • 无需数据线
  • pc和移动都可以调试
  1. 环境准备与安装
  • 环境:任何node.js 环境
  • 安装:npm install -g weinre
 weinre -h  #获取帮助信息
 weinre --boundHost=-all- --httpPort=1000 # 启动,boundHost为all是允许本机所有有效ip访问,默认端口8080
1
2
  • 浏览打开:ip:1000 或 http://localhost:1000/

  1. Target 页面配置
<!-- 往被调试页面添加脚本 -->
<script src="http://ip:端口/target/target-script-min.js#anonymous"></script>
<!-- 示例 -->
<script src="http://172.20.10.11:1000/target/target-script-min.js#anonymous"></script>
1
2
3
4
  1. 调试

调试移动手机的页面需要手机访问局域网内的页面服务(例如react开启了3000端口的服务,那么手机访问ip+3000)

扩展

weinre官网

# 8.3 在移动端调试

主流的移动端devTool

  • vConsole
  • eruda

扩展资料

vConsole项目主页

eruda项目主页

创建一个vConsole 插件

# 8.4 使用代理服务器进行调试(charles)

# 8.4.1 常见的代理服务器

  • Fiddler

    • C#编写
    • 正式版仅支持Windows
    • 请求展示:时间顺序
    • 支持解析HTTPS请求
    • 免费
  • Charles

    • java编写
    • 多平台支持
    • 请求展示:树状结构
    • 不支持直接解析HTTPS请求
    • 付费获得更好体验

# 8.4.2 HTTP抓包

  1. 移动端配置(配置代理)

点击手机连接的Wi-Fi->HTTP代理->配置代理

  • 服务器:填入电脑的ip地址(可以在charles查看 help->Local IP Address)
  • 端口:默认是8888
  1. 开始抓包

工具栏第二个按钮(红色说明正在抓包)

# 8.4.3 HTTPS抓包

charles不能直接抓包https,所以我们还需要进行以下操作

  1. 移动端配置代理

与上面http配置完全相同(切记!!!这一步一定要做,只有配置了代理服务,才能下载证书,因为这是你电脑上charles给你颁发的,你换了电脑还需要另一个电脑给你颁发)

  1. 添加要解析的域名列表
  • 菜单栏Proxy-> SSL Proxying Settings
  • 在Host一栏设置要解析的域名,也可以*表示所有的HTTPS都做解析,port:443;点击ok后重启charles。

设置后重启charles

  1. 信任Charles根证书
  • 在移动端用浏览器访问https:chls.pro/ssl下载证书描述文件
    • 安卓:直接安装即可
    • IOS:
      1. 在设置-通用-描述文件与设置管理中安装证书,
      2. 然后开启 设置-通用-关于本机-针对根证书启用完全信任

(当你访问上面chls网站时,电脑上charles会有一个弹窗询问你是否允许给手机安装证书,你要点同意(allow))

🍅 HTTPS 协议

  • https = http + sll(secure sockets layer)

发送一个HTTPS请求的过程简单来说客户端是向服务端索取一个公钥放在客户端,公钥的载体就是数字证书;客户端通过公钥加密,服务端通过私钥解密。

🍅 charles 代理HTTPS请求的机制

charles做客户端和服务端的中介,代理了https请求;charles会动态为每个服务器生成由charles根证书签发的数字证书;当请求产生时客户端收到的不是 服务端的原始证书而是charles签发的证书,原始证书是保存在charles上的;客户端与服务端的通信是由charles公钥加密的,而charles与原始服务器的通信是 由服务端的原始证书加密的,charles通过自己的私钥解密,所以我们能通过charles看见未加密的数据。

🍅 可能出现的问题

  1. 开启后电脑浏览器无法打开网页

关掉charles的External Proxy setting:点击顶部Proxy-> 去掉勾选 External Proxy Settings

  1. 开启手机代理后浏览器无法打开网页

    • 要保证电脑和手机同一个Wi-Fi,手机上填的代理服务器ip不要填错了,可以查看charles:Help/Local IP Address;端口一般是8888
    • 打开https的网站,会提醒不是安全连接,说明你证书没有安装正确,或者没有信任
    • 一般就上诉2个问题,也可以重启试试
  2. 关闭charles后 无法联网

打开网络偏好设置-> 高级 -> 代理 -> 检测网页代理和安全网页代理是否开启(不需要开启,你关闭charles后就没有代理服务器了,记得手机也取消代理配置)

  1. 抓取手机端的返回的是unknow
  • 确保证书在手机端被信任

  • safari浏览器访问https:chls.pro/ssl下载证书描述文件时候,确保配置了http代理(ip:8888), 如果换电脑需要再次下载证书,可以在描述文件中查看证书,charles通用名称中会包含你电脑系统的名称

  1. 手机开启代理后,也能访问网页,但是电脑上的charles没有抓取到数据
  • 检查代理是否正确
  • 重启charles

# 8.4.4 Map请求重定向

🍅 Map Local / Map Remote

  • 生产环境代码打包压缩后不利于debug
  • 调试时不方便频繁发布
  • Map Local:将某请求重定向至本地某个文件
  • Map Remote:将某请求重定向至另一个请求
  • 将生成环境的代码替换成本地的代码

🍅 Map Remote

尝试改动代码,查看页面变化

🍅 Map Local

Map Local可以替换任意charles能抓包到的文件,甚至可以将api请求替换成本地的json文件,做接口的一个mock, 其实就是一个文件的代理功能。

如果想取消Map Local / Map Remote:charles顶部tools-> Map Local / Map Remote -> 不勾选enable map local/Remote-> ok

# 8.4.5 Rewrite 修改请求内容

🍅 Rewrite功能

  • 可作用于:request & reponses
  • 可修改:header、host、path、url、params、body等
  • 采用新增、替换的形式

🍅 案例

向生产环境页面注入vConsole脚本

  1. 顶部tools-> Rewrite

添加匹配location

添加rewrite规则

上面其实就是将</head>标签替换成 <script src="<script src="https://cdn.bootcdn.net/ajax/libs/vConsole/2.5.0/vconsole.min.js"></script>">new VConsole()</script></head>

# 8.5 在公网访问本地服务

# 8.5.1 内网穿透

# 什么叫内网穿透

  • NAT(Network Address Translation)穿透
  • 从公网访问内网
  • 在公网访问部署在本地服务器上的服务
  • ngrok & localtunnel
    • 生成唯一可在公网访问的url,该url会在代理本地运行的web服务请求

# 8.5.2 localtunnel的使用

  1. 安装
    npm install -g localtunnel
    lt --help # 帮助信息
1
2
  1. 启动
    # -p 本地启动服务的端口,-s 指定自己子域名地址,也可以不指定
    lt -p 3000 -h https://tunnel.svrx.io -s mayi
    # 启动成功后 your url is: https://mayi.tunnel.svrx.io
    # 访问地址 https://mayi.tunnel.svrx.io
1
2
3
4

# 8.5.3 部署你的localtunnel服务

  • localtunnel默认服务在外国,不稳定,访问速度慢
  • 自己部署lt服务的机器需要满足:
    1. 支持DNS泛域名解析,比如:mydomain.com 和 *.mydomain.com
    2. Localtunnel服务端能监听任何非root权限的TCP端口
  1. 配置dns解析 添加两个A类记录

    • mydomain.com
    • *.mydomain.com
  2. 启动localtunnel server

    git clone git://github.com/defunctzombie/localtunnel-server.git
    cd localtunnel-server
    npm install
    bin/server --port 1234
    bin/server --port 1234 --domain sub.mydomain.com
1
2
3
4
5
  1. 在localtunnel客户端使用部署的host
    lt --host http://sub.mydomain.com:1234  --port 8000
1

# 8.6 随机数据生成(mock)

# 特点

  • “生成随机数据,拦截Ajax请求“

  • 业务代码物侵入

  • 数据类型丰富

  • 用法简单,可扩展性强

# 8.6.1 Mock.js 的安装及基本语法

// 安装
npm install mockjs

// 基本用法
const Mock = require('mockjs')
const data = Mock.mock({
  // 属性list 的值是一个数组,其中含有 1 到 10个元素,数组里的对象数量是随机的
  'list|1-10':[{
    // 属性id 是一个子增函数,起始值为1,每次增1
    'id|+1':1
  }]
})
// 输出结果
console.log(JSON.stringify(data,null,4))
1
2
3
4
5
6
7
8
9
10
11
12
13
14

🍅 mockjs的语法

// name 是属性名,rule是规则 ,value是属性值;属性名和规则之间是用|分割的
'name|rule':  value
 name: value

1. 'name|min-max': value
2. 'name|count': value
3. 'name|min-max.dmin-dmax': value
4. 'name|min-max.dcount': value
5. 'name|count.dmin-dmax': value
6. 'name|count.dcount':  value
7. 'name|+step': value
1
2
3
4
5
6
7
8
9
10
11
  • 属性值决定了规则的初始值和类型
  • 生成规则的含义需要依赖属性值的类型才能确定
  1. 属性值是字符串
  • 将value字符串重复min-max次
// 1. 'name|min-max': value  生成的数量是随机的
{'repeater|1-5': 'hi!'} -> { repeater: 'hi!hi!hi!'}
1
2
  • 将value字符串重复count次
// 2. 'name|count': value
{'repeater|2': 'hi!'} -> {repeater: 'hi!hi!'}
1
2
  1. 属性值是数字
  • 随机生成min-max 范围内的一个数字
 // 1. 'name|min-max': value
 // 现在value是数字,属性值决定了初始值,1和50也可以换成其他数字;不影响结果
 {'age|1-30': 1} -> { age: 22 }
 {'age|1-30': 50} -> { age:15 }
1
2
3
4
  • 随机生成一个小数,整数部分值在min-max范围内,小数部分位数在dmin-dmax之间
// 'name|min-max.dmin-dmax':vlaue
{ 'price|1-30.2-3': 1} -> { price: 20.28}
{ 'price|1-30.2-3': 1} -> { price: 4.827}
1
2
3
  1. 属性值是布尔值
  • 随机生成一个布尔值,其中value和!value的比例为min-max
    • value 概率 = min / (min+max)
    • !value 概率 = max / (min + max)
  // 'name|min-max':vlaue
  { 'active|1-1': true } -> { active: true }
  { 'active|1-1': true } -> { active: true }
1
2
3
  1. 属性值是对象
  • 从value中随机min-max个属性
  // 'name|min-max': vaule
  { 'user|1-2': { name: 'jack', age: 2 }} -> { user: { age:2}}
  { 'use|1-2': { name: 'jack', age: 2 }} -> { user: { name: 'jack', age:2 }}
1
2
3
  • 从value中随机取count个属性
// 从value中随机取count个属性
// ‘name|count’: value
{ 'user|1': { name: 'jack', age: 2}} -> { user: { age:2 }}
1
2
3
  1. 属性值是数组
  • 从value列表中随机获取1个元素
{ 'fruit|1': ['apple','banana']} -> { fruit: 'banana' }
1
  • 将value列表内的值重复min-max次
{ 'list|1-2': ['a']} -> { list: ['a']}
{ 'list|1-2': ['a']} -> { list: ['a','a']}
1
2
  1. 属性值是其它类型
  • 生成值为function执行结果
// function
{ age: ()=> 1 } -> { age:1 }
1
2
  • 随机生成符合正则表达式的字符串
// reExp
{ age: /1[0-9]/ } -> { age: '19' }
1
2

# 8.6.2 Mock.js的常用方法

  1. Mock.mock()
  • Mock.mock(rurl?,rtype?,template|function(options))
    • rurl: 要拦截的请求url,支持正则
    • rtype:要拦截的请求类型,如POST、GET、DELETE等
    • template:数据模版,支持对象、字符串
    • function(options): 生成相应数据的方法,options:{ url,type,body }

🍅 使用mock()方法拦截请求

//  在入口文件中引入mockjs,对 ‘api/activity‘进行拦截
import Mock from 'mockjs';

if(process.env.NODE_ENV !== 'production')
    Mock.mock(/api\/activity/,{
      code: 200,
      data: {
        'isLegal|2-1':false
      } 
    })
  }
1
2
3
4
5
6
7
8
9
10
11
  1. Mock.Random
  • 工具类
const { Random }  =  Mock;
Random.email()
// => "n.abc.@miller.io"
Random.image()
// => http://dummyimage.com/336x330
1
2
3
4
5

🍅 Mock.Random 支持的方法

type Method
Basic boolean、natural、integer、float、character、string、range、date、time、datetime、now
Image image、dateImage
Color color
Text paragraph、sentence、word、title、cparagraph
Name first、last、name、cfirst、clast、cname
Web url、domain、email、ip、tld
Address area、region
Helper capitalize、upper、lower、pick、shuffle
Miscellaneous guid、id

🍅 Mock.Random 与模版语法

const Mock =  require('mockjs');

const { Random } = Mock
const user = Mock.mock({
  code: '200',
  'list|10': [{
    name: `${Random.first()} ${Random.last()}`,
    avatar: Random.image()
  }]
})

console.log(users)

{
  code: 200,
  list: [
    { name:'Sarah Leris', avatar: 'http://dummyimage.com/300x600'},
    { name:'Sarah Leris', avatar: 'http://dummyimage.com/300x600'}
    .....
  ]
}
// 10个相同的对象
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

由于用Random生成的都是一样的,这可能不是我们想要的,我们想要每一个对象里的数据都不一样,那就看下面的占位符。

🍅 Mock.js 的占位符

  • 占位符
  • 使用最广泛
  • @占位符
  • @占位符(参数、[,参数])
  • 只是在属性值字符串中占个位置,并不出现在最终的属性值中
  • 实际采用Random中的方法计算
const Mock =  require('mockjs');

const { Random } = Mock
const user = Mock.mock({
 code: '200',
 'list|10': [{
   name: '@first @last',
   avatar: '@image'
 }]
})

console.log(users)

{
 code: 200,
 list: [
   { name:'Carol Brown', avatar: 'http://dummyimage.com/3335x220'},
   { name:'Angela Lopez', avatar: 'http://dummyimage.com/378x600'}
   .....
 ]
}
// 10个不同的对象
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

# 8.7 RestFul API 快速模拟

# 8.7.1 复杂的接口mock场景

# RESTful API

  • REpresentational State Transfer 表现层
  • 资源是由URI来指定:/songs(代表歌曲) /playlist/12(代表第12个playlist)
  • 对资源的操作包括增删改查:POST、DELETE、PUT和GET方法
  • 是一套API设计理论,约束规范、增强可读性、便于开发

# RESTful 规范

GET http://abc.com/api/playlists # 获取歌单列表
GET http://abc.com/api/playlist/12345 # 获取id为123456的歌单
POST http://abc.com/api/playlists # 添加一个歌单
DELETE http://music.163.com/api/palylist/55 # 删除id为 55 的歌单
PUT http://music.163.com/api/palylist/123456 # 删除id为 123456 的歌单

GET : 返回资源对象
POST :返回新生成的资源对象
PUT :返回完整的资源对象
DELETE:返回一个空文档

{
  "code": 200,
  "message": "success",
  "data": {
    playlist: {....}
  }
}

HTTP 状态码:
2xx: 请求成功
3xx:重定向
4xx:客户端错误
5xx:服务端错误
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
  • 如何mock对同一个资源的增删改查
  • 在前端运行、可以存储数据的server
  • JSON-Server :零开发,快速模拟RESTful API

# 8.7.2 JSON-server 的安装和用法

// install
npm install -g json-server

// db.json
{
    "songs":[
      { "id": 1, "name": "Baby"}
    ],
    "comments": [
      { "id": 1, "content": "nice" }
    ]
  }

// start server
json-server --watch db.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

运行成功输出的日志

  \{^_^}/ hi!

  Loading ./db.json
  Done

  Resources
  http://localhost:3000/songs
  http://localhost:3000/comments

  Home
  http://localhost:3000

  Type s + enter at any time to create a snapshot of the database
  Watching...

GET /songs 200 8.036 ms - 43
GET /songs 304 3.381 ms - -
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

GET http://localhost:3000/songs/1 会返回 { "id":1,"name":"Baby"} 根据songs/1路由1进行筛选

POST、PUT、PATCH、DELETE 操作会改变db.json文件的内容

🍅 Routes 规则-过滤

{
  "songs": [
    { "name": "吻别", "artist": "张学友" },
    { "name": "燃烧我的卡路里 ", "artist": "火箭少女 101" },
    { "name": "麻雀", "artist": "李荣浩" }
  ],
  "comments": [
      { "id": 1, "content": "nice" }
    ]
}
GET /songs?artist=张学友
GET /songs?artist=张学友&arttist=李荣浩
GET /comments?author.id=1
1
2
3
4
5
6
7
8
9
10
11
12
13

🍅 Routes 规则-翻页与排序

// 以_开头的是json-server的保留字
// 分页
GET /songs?_page=2
GET /songs?_page=1&_limit=15

// 排序
GET /songs?_sort=id&_order=asc

// 多字段排序
GET /songs/_sort=id,name&_order=desc,asc
1
2
3
4
5
6
7
8
9
10

🍅 Routes 规则-查询

// operators:
// _gte _lte _ne 大约小于等于
GET /users?age_gte=10&age_lte=20 
GET /users?age_ne=18

// _like 支持正则
GET /songs?name_like=// q 全局搜索
GET /songs?q=喜欢
1
2
3
4
5
6
7
8
9
10

🍅 自定义 routes

  • 更贴近后端接口
// routes.json
// 左边是实际访问的路径,右边是资源的路径
{
  "/api/*": "/$1",
  "/:resource/:id/show": "/:resource/:id", 
  "/posts/:category": "/posts?category=:cagegory",
  "/articles\\?id=:id": "/posts/:id"
}

// 添加启动参数:json-server db.json --routes routes.json
/api/posts // -> /posts
/api/posts/1  // -> /posts/1
/posts/1/show //  -> /posts/1
/posts/javascript // -> posts?category=javascript
/articles?id=1 // -> /posts/1
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

🍅 添加 middleware

  • 统一定制个性化请求
// my-middleware.js
module.exports= (req, res ,next) => {
  res.header('X-token',"xxxxx")
  next()
}
// 启动
json-server db.json --middlewares ./my-middleware.js
1
2
3
4
5
6
7

# 8.7.3 生成随机数据

当数据量过大时候,我们不能手写庞大数据量的db.json,json-server也支持js对象。

快速生成随机数据-Mock.js

// index.js
const Mock = require('mock.js')
module.exports= () => {
  const data = Mock.mock({
    'user|1000': [{{
      'id|+1': 1,
      'name': '@first @last'
    }]
  })
  return data
}
// 启动
json-server index.js --middlewares ./my-middleware.js
1
2
3
4
5
6
7
8
9
10
11
12
13

# 8.7.4 JSON-Server的基本使用

搭配Mock.js 生成随机数据接口

🍅 查询歌单列表

新建文件index.js

const Mock = require('mockjs')

module.exports= ()=> {
    const data = Mock.mock({
        'playlists|100': [{
            'id|+1':1,
            'name': '@title',
            'cover': '@image'
        }]
    })
    return data
}
1
2
3
4
5
6
7
8
9
10
11
12

新建routes.json

// /api/music/ 下面所有的请求转发到去掉这个前缀的下面
// $1 表示任意的字符
{
    "/api/music/*": "/$1"
}
1
2
3
4
5

启动 json-server index.js --routes routes.json

访问 http://localhost:3000/api/music/playlists可以获得100条数据

🍅 查询分页的歌单

修改routes.json

{
    "/api/music/*": "/$1",
    "/playlists\\?limit=:limit&offset=:offset": "/playlists?_start=:offset&_limit=:limit"
}
1
2
3
4

启动 json-server index.js --routes routes.json

访问 http://localhost:3000/api/music/playlists?limit=10&offset=20从20开始返回10条数据

🍅 新增一个歌单

// 用curl模拟一下请求 参数{"name":"夜曲","cover":"xxxx"}
curl localhost:3000/api/music/playlists -X POST -d '{"name":"夜曲","cover":"xxxx"}' -H 'Content-Type: application/json'
1
2

🍅 修改一个歌单

curl localhost:3000/api/music/playlists/101 -X PUT -d '{"id":101,"name":"月半小夜曲","cover":"xxxx"}' -H 'Content-Type: application/json'
1

🍅 删除一个歌单

curl localhost:3000/api/music/playlists/101 -X DELETE  -H 'Content-Type: application/json'
1

以上也可以用postman模拟请求

# 给所有的响应头添加header

新建middleware.js

json-server index.js --routes routes.json --middleware middleware.js
1

源码地址:/examples/engineering/8.6

# 8.8 Stream 手机抓包APP

安装软件-> 安装证书-> 信任证书

最新更新时间: 1/14/2024, 1:54:31 PM