v-zhzhou / can-autoplay

The auto-play feature detection in HTMLMediaElement (<audio> or <video>).

can-autoplay.js

The auto-play feature detection in HTMLMediaElement (<audio> or <video>).

Demo page

Table of contents:

• Installation
• API
  • audio(options)
  • video(options)
• Example

Installation

npm install can-autoplay

API

audio(options)

Parameters:

• options.muted <Boolean>, check if auto-play is possible for a muted content
• options.timeout <Number>, timeout for a check, default value is 250 ms

Returns:

• <Promise>, resoles to a <Object>:
  • result <Boolean>, true - if auto-play is possible
  • error <Error>, internal or timeout Error object

canAutoplay.audio().then(({result}) => {
  if (result === true) {
    // Can auto-play
  } else {
    // Can not auto-play
  }
})

video(options)

Parameters:

• options.muted <Boolean>, check if auto-play is possible for a muted content
• options.timeout <Number>, timeout for a check, default value is 250 ms

Returns:

• <Promise>, resoles to a <Object>:
  • result <Boolean>, true - if auto-play is possible
  • error <Error>, internal or timeout Error object

canAutoplay.video().then(({result}) => {
  if (result === true) {
    // Can autoplay
  } else {
    // Can not autoplay
  }
})

Example

import canAutoPlay from 'can-autoplay';

canAutoPlay
    .video({timeout: 100, muted: true})
    .then(({result, error}) => {
        if(result === false){
            console.warn('Error did occur: ', error)
        }
    })