Installation

|

MQL is available as

:

npm install @microlink/mql --save

The package is fully typed, and it has been designed for being consumed in different environments and ways.

From Node.js

Any Node.js above v22 is supported. We recommend running it using the active LTS. Check

Node.js releases

to know more.

Just require @microlink/mql dependency from your code:

const mql = require('@microlink/mql')

const { data } = await mql('https://kikobeats.com', {
  data: {
    avatar: {
      selector: '#avatar',
      type: 'image',
      attr: 'src'
    }
  }
})

console.log(`The avatar URL is '${data.avatar.url}' (${data.avatar.size_pretty})`)

The same build is available for CommonJS and ESM.

From Edge

If you are using

CloudFlare Workers

,

Vercel Edge Functions

,

Deno

, or any other provider that supports

WinterCG

, the Node.js ESM build is implemented on top of Web Standard APIs, nothing extra should be done.

Just import @microlink/mql/lightweight from your code:

import mql from '@microlink/mql/lightweight'

const { data } = await mql('https://kikobeats.com', {
  data: {
    avatar: {
      selector: '#avatar',
      type: 'image',
      attr: 'src'
    }
  }
})

console.log(`The avatar URL is '${data.avatar.url}' (${data.avatar.size_pretty})`)

The same build is available for CommonJS and ESM.

From Browser

Last but not least, MQL can be loaded from any browser directly from HTML markup:

<script type="module">
  import mql from 'https://esm.sh/@microlink/mql'

  const { data } = await mql('https://kikobeats.com', {
    data: {
      avatar: {
        selector: '#avatar',
        type: 'image',
        attr: 'src',
      }
    }
  })

  console.log(`The avatar URL is '${data.avatar.url}' (${data.avatar.size_pretty})`)
</script>