root.js 全局设置

在 root.js 中，提供了一个全局设置。在项目中需要引用一次，之后会保存在 LocalStorage 中。格式为：

其中singleSelector配置单元素选择器使用的方法符号，默认值为$，即可以通过$('#id')这个方法来选择元素。相应的，选择多个元素的方法符号为$$。注意这两个符号方法不是原生的$和$$方法，其中$等价于 root.js 库的$s，$$等价于$a。如果不想覆盖原生方法，则可以将这两个值替换为其他值，如$signle、$all等。

ajax 项的配置见下文的说明。

Ajax 接口请求配置

在前端开发中，请求接口是与后端交互最经常的操作。如下是一个典型的接口格式：

当接口正常时，返回以上数据。当接口错误时，则调用会失败，返回 500 错误。但是很多情况下，接口的根节点并不是所需要的数据，比如下面是一种更常见的接口格式：

上例中：

timestamp 接口请求时间戳。
elapsed 后端逻辑的处理时间，单位是毫秒。
status 当接口执行过程中不发生错误时，返回success，否则返回其他出错信息。当status为success时，这个接口的数据才可以用。
message 当接口出错时这里会显示错误信息。
data 当接口正常时，这里是前端所需要的数据，否则为null。

这种情况下，在使用数据之前我们就要对接口返回的数据先进行各种判断，例如：

如果把以上过程写在每个接口处理逻辑中，会是一个比较烦琐和痛苦的操作。在 root.js 库全局配置中，ajax 项用于接口请求的全局配置。

以上各参数的解释如下：

/api/是一个匹配模式，可以匹配一个或多个接口，上例中，所有包含/api/的接口都应用这个规则，支持正则表达式匹配（不区分大小写）。
ready 接口可用的条件，如上例是status == 'success'。
info 当接口异常时，指明从哪里获取错误信息，并发送给 Promise 对象的reject方法，JsonPath 格式。
path 当接口正常时，指明从哪里获取数据，并发送给 Promise 对象的resolve方法，JsonPath 格式。

设置好后，再使用/api/相关的接口时，就不需要每次都写上面的判断逻辑了。可以设置多个匹配规则，以针对不同的接口格式。

参考链接