透過超過 100 個技巧學習 Nuxt!

rollbar
nuxt-rollbar

整合 Rollbar 的 Nuxt 3 模組。

Nuxt Rollbar module

Nuxt Rollbar

npm version

Nuxt 3 模組,用於整合 Rollbar

設定

# pnpm
pnpm add -D nuxt-rollbar

# npm
npm i -D nuxt-rollbar

# yarn
yarn add -D nuxt-rollbar

基本用法

nuxt-rollbar 新增至 Nuxt 設定檔的 modules 區段,並提供您的 Rollbar 伺服器和/或用戶端存取權杖。

// `nuxt.config.ts`
export default defineNuxtConfig({
  modules: ['nuxt-rollbar'],

  rollbar: {
    serverAccessToken: 'SERVER_ACCESS_TOKEN',
    clientAccessToken: 'CLIENT_ACCESS_TOKEN',
  },
});

完成!Rollbar 現在將在您的應用程式中運行。

組態

僅限用戶端

ℹ️ useRollbar composable 在伺服器端將回傳 undefined

export default defineNuxtConfig({
  modules: ['nuxt-rollbar'],

  rollbar: {
    clientAccessToken: 'CLIENT_ACCESS_TOKEN',
    mode: 'client',
    config: {
      // Rollbar configuration
    },
  },
});

僅限伺服器端

ℹ️ useRollbar composable 在用戶端將回傳 undefined

export default defineNuxtConfig({
  modules: ['nuxt-rollbar'],

  rollbar: {
    serverAccessToken: 'SERVER_ACCESS_TOKEN',
    mode: 'server',
    config: {
      // Rollbar configuration
    },
  },
});

伺服器和用戶端皆可

export default defineNuxtConfig({
  modules: ['nuxt-rollbar'],

  rollbar: {
    serverAccessToken: 'SERVER_ACCESS_TOKEN',
    clientAccessToken: 'CLIENT_ACCESS_TOKEN',
    config: {
      // Rollbar configuration
    },
  },
});

模組選項

選項類型預設值描述
clientAccessTokenstring''Rollbar 用戶端存取權杖。
serverAccessTokenstring''Rollbar 伺服器存取權杖。
modestring'all'Rollbar 實例運行的環境模式。
configRollbar.ConfigurationnullRollbar 組態。

Composables

與 Nuxt 3 生態系統中的其他 composable 一樣,它們會自動匯入,並可在您應用程式的元件中使用。

ℹ️ 由於 Rollbar 實例在用戶端和伺服器環境中都可用,因此您可以在任一環境中使用它。

useRollbar

如果 Rollbar 實例可用且已針對環境(用戶端或伺服器)設定,則傳回 Rollbar 實例。否則,回傳 undefined

類型宣告

function useRollbar(): Rollbar;

範例

const rollbar = useRollbar();

rollbar.log('Hello, world!');

此 composable 是以下項目的簡單別名

useNuxtApp().$rollbar;

💻 開發

  1. 複製此儲存庫
  2. 使用 corepack enable 啟用 Corepack
  3. 使用 pnpm install 安裝依賴項
  4. 執行 pnpm run dev:prepare
  5. 使用 pnpm run dev 啟動開發伺服器

感謝

特別感謝

感謝提供的靈感和基礎工作。

許可證

MIT 許可證 © 2023 Jairo Blatt