Web Utilities

ethers.utils.fetchJson( urlOrConnectionInfo [ , json [ , processFunc ] ] ) Promise< any >

urlOrConnectionInfo中获取并解析JSON内容,body参数json、processFun(在返回前处理result内容)是可选的。

ethers.utils.poll( pollFunc [ , options ] ) Promise< any >

使用PollOptions反复调用pollFunc直到它返回一个非undefined的值。

ConnectionInfo

connection.url string

要连接的URL。

connection.user string

用于Basic Authentication的用户名。默认为null(即不使用基本身份验证)

connection.password string

用于Basic Authentication的密码。默认为null(即不使用基本身份验证)

connection.allowInsecureAuthentication boolean

允许对不安全的HTTP进行Basic Authentication。默认值为false。

connection.timeout number

表示在遇到timeout错误并交易被拒绝之前,需要等待多长的时间。

connection.headers {[key:string]:string}

包含在连接中的额外的头文件。

PollOptions

options.timeout number

表示经过连接多长的时间,才会触发超时错误。

options.floor number

允许Exponential Backoff的最小时间限制。

默认值是0s。

options.ceiling number

允许Exponential Backoff的最大时间限制。

默认值是10s。

options.interval number

Exponential Backoff计算期间所用到的interval。

默认值是250ms。

options.retryLimit number

在发生错误或返回undefined的情况下进行重试的次数。

options.onceBlock Provider

如果指定了该值,轮询将等待来自provider的新区块,然后再执行pollFunc

options.oncePoll Provider

如果指定了该值,provider的每个轮询周期将会进行轮询,然后再执行pollFunc