next/script

Examples

Version History

VersionChanges
v12.2.4onReady prop added.
v11.0.0next/script introduced.

Note: This is API documentation for the Script Component. For a feature overview and usage information for scripts in Next.js, please see Script Optimization.

Optional Props

src

A path string specifying the URL of an external script. This can be either an absolute external URL or an internal path.

strategy

The loading strategy of the script.

strategyDescription
beforeInteractiveLoad script before the page becomes interactive
afterInteractiveLoad script immediately after the page becomes interactive
lazyOnloadLoad script during browser idle time
workerLoad script in a web worker

Note: worker is an experimental strategy that can only be used when enabled in next.config.js. See Off-loading Scripts To A Web Worker.

onLoad

A method that returns additional JavaScript that should be executed once after the script has finished loading.

Note: onLoad can’t be used with the beforeInteractive loading strategy. Consider using onReady instead.

The following is an example of how to use the onLoad property:

  1. import { useState } from 'react'
  2. import Script from 'next/script'
  3. export default function Home() {
  4. const [stripe, setStripe] = useState(null)
  5. return (
  6. <>
  7. <Script
  8. id="stripe-js"
  9. src="https://js.stripe.com/v3/"
  10. onLoad={() => {
  11. setStripe({ stripe: window.Stripe('pk_test_12345') })
  12. }}
  13. />
  14. </>
  15. )
  16. }

onReady

A method that returns additional JavaScript that should be executed after the script has finished loading and every time the component is mounted.

The following is an example of how to use the onReady property:

  1. import { useState } from 'react'
  2. import Script from 'next/script'
  3. export default function Home() {
  4. return (
  5. <>
  6. <Script
  7. id="google-maps"
  8. src="https://maps.googleapis.com/maps/api/js"
  9. onReady={() => {
  10. new google.maps.Map(ref.current, {
  11. center: { lat: -34.397, lng: 150.644 },
  12. zoom: 8,
  13. })
  14. }}
  15. />
  16. </>
  17. )
  18. }

onError

A method that executes if the script fails to load.

Note: onError can’t be used with the beforeInteractive loading strategy.

The following is an example of how to use the onError property:

  1. import Script from 'next/script'
  2. export default function Home() {
  3. return (
  4. <>
  5. <Script
  6. id="will-fail"
  7. src="https://example.com/non-existant-script.js"
  8. onError={(e) => {
  9. console.error('Script failed to load', e)
  10. }}
  11. />
  12. </>
  13. )
  14. }