swup swup Debug Plugin
GitHub swup on GitHub

Debug Plugin

A swup plugin for debugging and helping in development.

  • Detect common mistakes and suggest solutions in the console
  • Output all triggered hooks to the console as they happen
  • Configure swup's log method to make its output visible

Installation

Install the plugin from npm and import it into your bundle.

npm install @swup/debug-plugin
npm install @swup/debug-plugin
import SwupDebugPlugin from '@swup/debug-plugin';
import SwupDebugPlugin from '@swup/debug-plugin';

Or include the minified production file from a CDN:

<script src="https://unpkg.com/@swup/debug-plugin@4"></script>
<script src="https://unpkg.com/@swup/debug-plugin@4"></script>

Usage

To run this plugin, include an instance in the swup options.

const swup = new Swup({
  plugins: [new SwupDebugPlugin()]
});
const swup = new Swup({
  plugins: [new SwupDebugPlugin()]
});

Options

globalInstance

If true, the plugin will store the swup instance on the global window object, making swup available at window.swup. Defaults to false.

{
  globalInstance: true
}
{
  globalInstance: true
}