Uninote
Uninote
用户根目录

注意

  • 关闭移动端模式,否则不能选择复制文本

快捷键

使用快捷键,提高效率

界面布局

https://docs.dajxyl.com/book/1/2938#690316DFFC

系统参数配置

https://docs.dajxyl.com/book/1/2878#50947DBCF4

url 配置

所有的配置都可以配置在 url 中,这样可以将不同的配置保存为不同的书签方便使用,也方便分享给他人

修改配置的方式:

  • 直接在 url 中修改后回车
  • 点击“配置参数”按钮,在“url参数”部分中配置

所有支持的配置的列表(通用配置,有的模块可能有自己的独有配置),用法参考相关章节:

local storage 配置

所有在 url 中配置的参数,也可以在 local storage 中配置(除了 select-moudle, select-api):

区别如下:

  • 如果同时配置了,url 中配置的优先级更高
  • url 是局部配置,只对当前页面有效
  • local storage 是全局配置,对所有相同域名下的页面有效

url rewrite 配置

https://docs.dajxyl.com/book/1/2939#649E3B2A86

全局初始化

参数配置好后,就可以进行全局初始化了。

主要是进行必要的登录和初始化,并将 token 等数据存入 local storage 中

查看接口

所有接口按模块划分

  • 1 选择模块
  • 2 选择接口
  • 3 接口参数字段说明
  • 4 接口返回值说明

注意模块前缀https://docs.dajxyl.com/book/1/2939#83BEC36C44

搜索接口

  • 如果知道某个接口在哪个模块,可以直接选择该模块,然后搜索框中输入关键字过滤
  • 如果不知道某个接口在哪个模块,可以点击“接口清单”按钮,此时会输出所有符合模块过滤条件以及url 过滤条件的接口信息
    • 每条记录的格式:【模块路径】【接口描述-接口名】接口路径
    • 如果想要查询所有的接口,将 mi/me 参数删除即可。

请求接口

参数表单

  • 每个参数由三种值共同决定:默认值,生成值,自定义值,从左到右优先级依次提高。即,如果定义了“自定义值”,则最终传递的参数为“自定义值”,以此类推。

默认值

顾名思义

powder 自动根据默认值推导出参数类型

  • no default 选项:勾选时,则不会使用默认值,因此,如果没有“自定义值”,同时没有“生成值”,请求的参数中将没有此字段

生成值

https://docs.dajxyl.com/book/1/2938#3287D9365E

生成函数

  • 一个接口,对应 0-n 个生成函数(左上角下拉选择)
  • 每个生成函数,会通过各种必要的手段(包括调用接口等),生成合理、有效的参数,为下一步发送请求做好准备
  • 可以通过调试器的 source 面板查看生成函数的逻辑,对应关系如图:

  • 也可以通过 network 的堆栈快速定位:network 面板堆栈定义(点击 powder_gene 上面的 func)

自定义值

供用户手动填写参数的地方,优先级最高

类型转换

  • 期望类型由 默认值 决定(默认为 string)
  • 期望类型不是 string 时,会尝试解析为 json(可能值:对象、数组、数字)
    • 支持单引号
    • 支持结尾的逗号,eg:[1,2,]

发送请求

https://docs.dajxyl.com/book/1/2939#2B316A5513

类型校验

  • 最终类型(resovled type):最终计算出的参数的类型
  • 校验规则:最终类型 === 期望类型
  • 检验失败则不发送请求,提示相应的错误

url rewrite

url 拼接

返回值

注意,界面上的返回值只会展示数组的第一个元素(默认, as sample 勾选时),要查看完整的返回值,请移步调试器的 network 面板

  • 不勾选 as sample,这样查看返回结果有时更简单,不用一个一个的点击展开

完整验证

返回值验证

验证状态码和数据结构

单元测试

实例代码:https://docs.dajxyl.com/book/1/2257#DB817E0B31

一共有四种完整验证:

之间的关系为:系统中包含多个模块,一个模块包含多个接口,一个接口包含多个生成函数,也就是说,从左到右,点击按钮后需要执行的完整验证逐渐增多。

所有模块-批量完整验证

默认对所有模块的所有接口,进行完整验证

模块过滤

配置用法

使用场景:

  • 仅验证部分模块
  • 排除部分模块不验证

过滤条件:模块路径是否匹配(字符串检索) 配置形式:所有的配置项以 ':' 分隔

  • 包含配置 mi(module include):如果配置了,则只有匹配的模块才验证;如没有配置,则默认全部验证

  • 排除配置 me(module exclude):如果配置了,则匹配的模块不验证。

  • 如果两者同时配置了,谁的匹配长度长,谁的优先级高

  • 配置实例(以 url 配置举例):

    • mi=client:scms&me=client/shop/cart # 仅包含 client, scms 模块,但排除了 client/shop/cart 模块(同时匹配,排除匹配的匹配长度更长,优先级更高)
    • me=index:cms # 包含所有模块,但排除 index, cms 模块
    • 注意是 字符串检索,因此上面示例的也会排除形如 staff/cms 这种模块

url 过滤

  • 类似于模块过滤,但控制粒度更细

  • 配置方式同模块过滤:

    • 包含配置 ui(url include):如果配置了,则只有匹配的 url 才验证;如没有配置,则默认全部验证
    • 排除配置 ue(url exclude):如果配置了,则匹配的 url 不验证。
    • 如果两者同时配置了,谁的匹配长度长,谁的优先级高
  • 配置实例:

    • ui=user/&ue=user/register # 所有 url 包含 user,但排除了 user/register 的 api

powder

powder-api

点赞(0) 阅读(1) 举报
目录
标题