unplugin-turbo-console

🎥 Demo

🔥 Features

• Printing the file name, line number and variable name.

• Support inserting custom prefix and suffix strings in the console output.

• Support highlight the console output based on different file types. (such as js(x), ts(x), vue, svelte, astro)

• Allow jumping to the editor source code from the console output with one click.

• Pass server logs to client.

📦 Install

# npm
npm install -D unplugin-turbo-console
# yarn
yarn add -D unplugin-turbo-console
# pnpm
pnpm i -D unplugin-turbo-console

🦄 Usage

[!TIP] You can view all project examples here.

Vite

// vite.config.ts
import { defineConfig } from 'vite'
import TurboConsole from 'unplugin-turbo-console/vite'

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [
    TurboConsole({
      /* options here */
    })
  ],
})

Nuxt

// nuxt.config.ts
// https://nuxt.com/docs/api/configuration/nuxt-config
export default defineNuxtConfig({
  modules: [
    'unplugin-turbo-console/nuxt'
  ],
  turboConsole: {
    /* options here */
  }
})

Webpack

// webpack.config.js
module.exports = {
  /* ... */
  plugins: [
    require('unplugin-turbo-console/webpack')({ /* options */ }),
  ],
}

Vue CLI

// vue.config.js
const { defineConfig } = require('@vue/cli-service')

module.exports = defineConfig({
  transpileDependencies: true,
  parallel: false,
  configureWebpack: {
    plugins: [
      require('unplugin-turbo-console/webpack')({
        /* options here */
      })
    ]
  }
})

Sveltekit

⚠️ Please add TurboConsole plugin before Sveltekit plugin

import { sveltekit } from '@sveltejs/kit/vite';
import { defineConfig } from 'vite';
import TurboConsole from 'unplugin-turbo-console/vite'

export default defineConfig({
	plugins: [
		TurboConsole(),
		sveltekit()
	]
});

Astro

// astro.config.mjs
import { defineConfig } from 'astro/config'
import TurboConsole from 'unplugin-turbo-console/astro'

// https://astro.build/config
export default defineConfig({
  integrations: [
    TurboConsole()
  ]
})

Next.js

// next.config.js
/** @type {import('next').NextConfig} */
const nextConfig = {
  webpack(config) {
    config.plugins.push(
      require('unplugin-turbo-console/webpack')()
    )

    return config
  }
}

module.exports = nextConfig

Farm

// farm.config.ts
import { defineConfig } from '@farmfe/core';
import vue from '@vitejs/plugin-vue';
import TurboConsole from 'unplugin-turbo-console/farm'

export default defineConfig({
  vitePlugins: [
    vue(),
  ],
  plugins: [
    TurboConsole()
  ]
});

Rspack (Experimental)

// rspack.config.js
const rspack = require('@rspack/core')
const { VueLoaderPlugin } = require('vue-loader')
/** @type {import('@rspack/cli').Configuration} */

const config = {

  plugins: [
    new VueLoaderPlugin(),
    new rspack.HtmlRspackPlugin({
      template: './index.html'
    }),
    require('unplugin-turbo-console/rspack')(),
  ],

}
module.exports = config

Options

export interface Options {
  /**
   * Add a string prefix to the console log.
   *
   * @defaultValue ''
   */
  prefix?: string
  /**
   * Add a string suffix to the console log.
   *
   * @defaultValue ''
   */
  suffix?: string
  /**
   * Whether to disable the launch editor feature.
   *
   * @defaultValue false
   */
  disableLaunchEditor?: boolean
  /**
   * Whether to disable the highlight output feature.
   *
   * @defaultValue false
   */
  disableHighlight?: boolean
  /**
   * The specific service port of launch editor server.
   *
   * @defaultValue 3070
   */
  port?: number
}

Refer all options.

Disable plugin by comments

From v1.5.0, you can use code comments to make the plugin ignore specific console statements.

• One line disable

// turbo-console-disable-next-line
console.log('foo')
console.log('bar') // turbo-console-disable-line

• Entire file disable

/* turbo-console-disable (On top of file) */  
console.log('foo')
console.log('bar')

Shared logs between client and server

TypeSciprt

Add unplugin-turbo-console/client to your tsconfig.json:

{
  "compilerOptions": {
    // ...
    "types": [
      "unplugin-turbo-console/client"
    ],
  },
}

Init

Add it at your client entrance (Nuxt usage):

app.vue

<script setup lang="ts">
import '~console'
</script>

Server logs to client

On the server side, use ClientConsole instead of console

import { ClientConsole } from 'unplugin-turbo-console/helper'

export default defineEventHandler(async (event) => {
  const raw = await fetch('https://jsonplaceholder.typicode.com/users')
  const data = await raw.json()
  
  ClientConsole.log({data})
  ClientConsole.warn('A warning message from server!!')
  ClientConsole.error('An error message from server!!')
  
  return {
    data
  }
})

Client logs to server

On the client, use ServerConsole instead of console

<script setup lang="ts">
import { ServerConsole } from 'unplugin-turbo-console/helper'

ServerConsole.log('A log message from client!')

</script>

Troubleshooting

Jump to editor does't work

If you get errors like this:

Could not open xxxx in the editor.

The editor process exited with an error: spawn code ENOENT.

Please make sure the code command is installed. Check more details here.

❤️ Credits

Thanks these awesome project:

babel-plugin-enhance-log

turbo-console-log

vite-plugin-console-line

vite-plugin-terminal

Nuxt's server logs feature