Registry / http-networking / vite-plugin-translate

vite-plugin-translate

library0.0.6jsnpmunverified

Vite plugin that integrates translate.js for automatic website translation. Current stable version is 0.0.6, with initial release in 2024. It handles bundling the translate.js library, emitting it to the build output with version/timestamp in filename, and injecting script tags into HTML. Supports translate.js versions 3.18.66 and 4.0.3. Optionally injects an initialization script after translate.js loads. Requires Vite >=5 as a peer dependency. Ships TypeScript types.

http-networking web-framework

npm install vite-plugin-translate

github ↗package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-TRANSL

vite-plugin-translate

http-networkingjavascriptv0.0.6

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ViteTranslatePlugin

✓ import { ViteTranslatePlugin } from 'vite-plugin-translate'

✗ import ViteTranslatePlugin from 'vite-plugin-translate'

Named export, not default export.

PluginOptions

✓ import type { PluginOptions } from 'vite-plugin-translate'

✗ import { PluginOptions } from 'vite-plugin-translate'

PluginOptions is a type, so use `import type` in TypeScript.

require

✓ const { ViteTranslatePlugin } = require('vite-plugin-translate')

✗ const ViteTranslatePlugin = require('vite-plugin-translate').default

CJS usage: destructure the named export, not .default.

Integrates translate.js into a Vite project with version and initialization script.

import { defineConfig } from 'vite' import { ViteTranslatePlugin } from 'vite-plugin-translate' export default defineConfig({ plugins: [ ViteTranslatePlugin({ version: '4.0.3', initializeScript: ` translate.language.setLocal('english'); translate.execute(); `, }), ], })

Debug

Known issues

breakingIn v0.0.5, the `injectTo` option was removed. If you were using it, your config will fail silently (no error).

fix

Remove `injectTo` from plugin options. The plugin now injects script tags in a fixed manner.

affects: <=0.0.4

deprecatedThe `initializeScript` option may be deprecated in future versions. The plugin currently injects it as a second script tag.

fix

No action required yet, but watch for changelogs.

affects: >=0.0.6

gotchaPlugin only works with translate.js versions 3.18.66 and 4.0.3. Unsupported versions will cause runtime errors.

fix

Ensure you pass a supported version string to the `version` option.

affects: >=0.0.0

gotchaThe plugin depends on Vite >=5. Using it with Vite 4 or earlier will result in a peer dependency warning and potential incompatibility.

fix

Upgrade Vite to version 5 or higher.

affects: >=0.0.0

gotchaThe plugin injects scripts into the HTML automatically; disabling or overriding this may require advanced configuration.

fix

If you need custom script injection, consider forking the plugin or using a different approach.

affects: >=0.0.0

Errors

Common errors & fixes

Error: The 'version' option is required for ViteTranslatePlugin

Missing or undefined version option in plugin configuration.

fix

Add `version: '4.0.3'` (or another supported version) to the plugin options.

Cannot find module 'vite-plugin-translate' when using require()

Using CommonJS require with default import syntax instead of destructuring.

fix

Use `const { ViteTranslatePlugin } = require('vite-plugin-translate')`.

TypeError: ViteTranslatePlugin is not a constructor

Importing as default export instead of named export.

fix

Use `import { ViteTranslatePlugin } from 'vite-plugin-translate'`.

Uncaught ReferenceError: translate is not defined

Initialization script runs before translate.js is fully loaded.

fix

Ensure `initializeScript` is set and that it runs after the library loads (the plugin handles this automatically).

Upgrade

Version history

0.0.6latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

19 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/hackycy-collection/translation-master ↗

packagehttps://www.npmjs.com/package/vite-plugin-translate ↗