ethers.js/docs/v5/api/utils/web
2020-11-22 23:07:13 -05:00
..
index.html docs: updated generated docs. 2020-11-22 23:07:13 -05:00
README.md docs: updated generated docs. 2020-11-22 23:07:13 -05:00

Documentation: html

Web Utilities

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

Fetch and parse the JSON content from urlOrConnectionInfo, with the optional body json and optionally processing the result with processFun before returning it.

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

Repeatedly call pollFunc using the PollOptions until it returns a value other than undefined.

ConnectionInfo

connection . url => string

The URL to connect to.

connection . user => string

The username to use for Basic Authentication. The default is null (i.e. do not use basic authentication)

connection . password => string

The password to use for Basic Authentication. The default is null (i.e. do not use basic authentication)

connection . allowInsecureAuthentication => boolean

Allow Basic Authentication over non-secure HTTP. The default is false.

connection . timeout => number

How long to wait before rejecting with a timeout error.

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

Additional headers to include in the connection.

PollOptions

options . timeout => number

The amount of time allowed to elapse before triggering a timeout error.

options . floor => number

The minimum time limit to allow for Exponential Backoff.

The default is 0s.

options . ceiling => number

The maximum time limit to allow for Exponential Backoff.

The default is 10s.

options . interval => number

The interval used during Exponential Backoff calculation.

The default is 250ms.

options . retryLimit => number

The number of times to retry in the event of an error or undefined is returned.

options . onceBlock => Provider

If this is specified, the polling will wait on new blocks from provider before attempting the pollFunc again.

options . oncePoll => Provider

If this is specified, the polling will occur on each poll cycle of provider before attempting the pollFunc again.