waitforselector

    1.4.1 • Public • Published

    waitForSelector npm Package

    Wait for an element(s) with a specific selector to appear

    API

    waitForSelector(selector, cb[, options])

    selector

    Type: String | Array
    Css selector or an array of selectors

    cb

    Type: Function
    Callback function

    options.target

    Type: Element
    Default: document.body

    options.endless

    Type: Boolean
    Default: false
    Sometimes elements can be appended, removed and appended again. This option allows you to track each append of an element into the DOM structure.

    options.race

    Type: Boolean
    Default: false
    Wait until one of the given selectros appears in DOM

    options.timeout

    Type: Number
    Default: 0
    Stop waiting after this amount of milliseconds.
    Calls cb function with no arguments. Turned off by default.

    @return

    Returns stop method

    Usage

    // Single
    waitForSelector('.block3', (elem) => {
       // => <div class="block3"></div>
    })
     
    // Multiple
    waitForSelector(['.block1', '.block2', '.block4', '.block8'], (list) => {
       // => ['.block4', '.block2', '.block8', '.block1']
    })
     
    // Race
    waitForSelector(['.block7', '.block4', '.block5', '.block4'], (elem) => {
       // => <div class="block5"></div>
    }, { race: true })

    Changelog

    v1.3.0 (2020-02-29):

    • moved from setInterval to MutationObserver

    v1.2.2 (2019-09-14):

    • delay option renamed to interval
    • added timeout option

    Install

    npm i waitforselector

    DownloadsWeekly Downloads

    12

    Version

    1.4.1

    License

    MIT

    Unpacked Size

    6.67 kB

    Total Files

    5

    Last publish

    Collaborators

    • tpkn