feat: support manual script deduping

[harlan-zw]

Fixes #97

🔗 Linked issue

❓ Type of change

• 📖 Documentation (updates to the documentation or readme)
• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality)
• ✨ New feature (a non-breaking change that adds functionality)
• 🧹 Chore (updates to the build process or auxiliary tools and libraries)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

Loading multiple of the same script

You may have a setup where you need to load the same registry script multiple times
using different configuration.

By default, they will be deduped and only loaded once, to load multiple instances of the same script, you can provide a unique key to the script.

const { gtag, $script } = useScriptGoogleAnalytics({
  id: 'G-TR58L0EF8P',
})

const { gtag: gtag2, $script: $script2 } = useScriptGoogleAnalytics({
  // without a key the first script instance will be returned
  key: 'gtag2',
  id: 'G-1234567890',
})

It's important to note that when modifying the key, any environment variables you're using will break.

For example, with gtag2 as the key, you'd need to provide runtime config as following:

export default defineNuxtConfig({
  runtimeConfig: {
    public: {
      scripts: {
        gtag2: {
          id: '', // NUXT_PUBLIC_SCRIPTS_GTAG2_ID
        },
      },
    },
  },
})

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
scripts-docs	🔄 Building (Inspect)	Visit Preview	💬 Add feedback	Jul 13, 2024 8:34am
scripts-playground	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 13, 2024 8:34am