特徴
基本的に、Vite を使用した開発は静的ファイルサーバを使用した時とそれほど変わりません。しかし、Vite はバンドラベースのセットアップで一般的な機能をサポートするためにネイティブ ESM をインポートすることで様々な拡張機能を提供します。
NPM の依存関係の解決と先読みされるバンドル
ネイティブ ES のインポートは次のような生のモジュールをサポートしていません:
import { someMethod } from 'my-dep'
上のようなコードはブラウザでエラーになります。Vite は提供される全てのソースファイルでこのような生のモジュールのインポートを検出し以下を実行します:
先読みバンドル はページの読み込み速度を改善し、CommonJS / UMD モジュールを ESM に変換します。先読みバンドルは esbuild で実行され、Vite のコールドスタート時間を JavaScript ベースのバンドラよりも大幅に高速化します。
インポートを
/node_modules/.vite/my-dep.js?v=f3sf2ebd
のように書き換えることでブラウザが正しくモジュールをインポートできるようにします。
依存関係は積極的にキャッシュされます
Vite は HTTP ヘッダを介して依存関係のリクエストをキャッシュするため、依存関係をローカルで編集/デバッグする場合は、ここの手順に従います。
Hot Module Replacement
Vite はネイティブ ESM を介して HMR API を提供します。HMR 機能を備えたフレームワークは、API を活用して、ページを再読み込みしたり、アプリケーションの状態を損失することなく即座に正確な更新を提供できます。Vite は Vue Single File Components および React Fast Refresh ファーストパーティの HMR を提供します。@prefresh/vite を介した Preact の統合された公式のライブラリもあります。
これらを手動で設定する必要がないことには注意してください - create an app via create-vite
を介してアプリケーションを作成する場合、これらはすでに構成されています。
TypeScript
Vite は .ts
ファイルをインポートすることをサポートしています。
Vite は .ts
ファイルに対してのみ変換を実行し、型チェックは 実行しません。型チェックは IDE とビルドの過程にて実行されることを前提としています (ビルドスクリプト内で tsc --noEmit
を実行するか、vue-tsc
をインストールして vue-tsc --noEmit
を実行することで *.vue
ファイルの型チェックもできます)。
Vite は esbuild を用いて TypeScript を JavaScript に変換します。これは、vanilla の tsc
よりも約 20〜30 倍速く、HMR の更新は 50 ミリ秒未満でブラウザに反映されます
型のみのインポートやエクスポート構文を使用すると、型のみのインポートが正しくバンドルされないなどの潜在的な問題を回避できます。例えば:
import type { T } from 'only/types'
export type { T }
TypeScript コンパイラオプション
tsconfig.json
の compilerOptions
にあるいくつかの設定フィールドには、特別な注意が必要です。
isolatedModules
true
に設定する必要があります。
esbuild
は型情報なしにトランスパイルを行うだけなので、const enum や暗黙の型のみのインポートなどの特定の機能をサポートしていないからです。
隔離されたトランスパイルで動作しない機能を TS が警告するように、tsconfig.json
の compilerOptions
で "isolatedModules": true
を設定する必要があります。
しかし、一部のライブラリ (例えば vue
) は "isolatedModules": true
でうまく動作しないことがあります。skipLibCheck": true
を使用すると、アップストリームで修正されるまで一時的にエラーを抑制することができます。
useDefineForClassFields
Vite 2.5.0 からは、TypeScript ターゲットが ESNext
の場合、デフォルト値は true
になります。これは tsc
4.3.2 以降の動作と一致しています。また、これは ECMAScript の標準的なランタイムの動作でもあります。
しかし、他のプログラミング言語や古いバージョンの TypeScript を使用している人にとっては直感的に理解できないかもしれません。 移行の詳細については、TypeScript 3.7 リリースノートを参照してください。
クラスフィールドに大きく依存しているライブラリを使用している場合は、そのライブラリが意図している使い方に注意してください。
MobX、Vue Class Components 8.x など、ほとんどのライブラリは "useDefineForClassFields": true
を想定しています。
しかし、lit-element
など、まだこの新しいデフォルトに移行していないライブラリもあります。これらの場合は、明示的に useDefineForClassFields
を false
に設定してください。
ビルド結果に影響するその他のコンパイラオプション
もしコードベースを "isolatedModules": true
に移行することが無理な場合は、rollup-plugin-friendly-type-imports のようなサードパーティのプラグインを使って回避できるかも知れません。しかし、この方法は Vite では公式にサポートされていません。
クライアントのタイプ
Vite はデフォルトでは Node.js の API を提供します。Vite でクライアント用のコードを使用するには d.ts
の定義ファイルを追加します:
/// <reference types="vite/client" />
tsconfig
の compilerOptions.types
に vite/client
を追加することもできます:
{
"compilerOptions": {
"types": ["vite/client"]
}
}
これにより次のことが提供されます:
- アセットのインポート (例:
.svg
ファイルのインポート) import.
に Vite が挿入した env variables のタイプmeta.env import.
の HMR API のタイプmeta.hot
Vue
Vite は Vue に対して最高のサポートをします:
- Vue 3 SFC はこちら @vitejs/plugin-vue
- Vue 3 JSX はこちら @vitejs/plugin-vue-jsx
- Vue 2 はこちら underfin/vite-plugin-vue2
JSX
.jsx
と .tsx
も標準サポートされます。JSX のトランスパイルも esbuild を介して行われます。デフォルトは React 16 フレーバですが、esbuild での React 17 スタイルの JSX サポートが追跡されます。詳しくはこちら。
Vue を使用している人は公式の @vitejs/plugin-vue-jsx プラグインを使用するべきです。これは、HMR、グローバルコンポーネント解決、ディレクティブ、スロットなど、Vue 3 の固有の機能を提供します。
もし React、または Vue で JSX を使用していない場合は、esbuild
オプション を使用して jsxFactory
および jsxFragment
を構成することができます。例えば、Preact の場合:
// vite.config.js
import { defineConfig } from 'vite'
export default defineConfig({
esbuild: {
jsxFactory: 'h',
jsxFragment: 'Fragment'
}
})
さらに詳しく知りたい場合は esbuild docs を見てください。
また、jsxInject
(Vite のみのオプション)を使用して JSX ヘルパを挿入し、手動インポートを回避できます。
// vite.config.js
import { defineConfig } from 'vite'
export default defineConfig({
esbuild: {
jsxInject: `import React from 'react'`
}
})
CSS
.css
ファイルをインポートすると、HMR をサポートする <style>
タグを介してそのコンテンツがページに挿入されます。モジュールのデフォルトのエクスポートとして、処理された CSS を文字列として取得することもできます。
@import
のインライン化と結合
Vite は、postcss-import
を介した CSS @import
のインライン化をサポートするように事前構成されています。CSS @import
では、Vite エイリアスも尊重されます。さらに、インポートされたファイルが異なるディレクトリにある場合でも、すべての CSS url()
参照は、正確性を確保するために常に自動的に結合されます。
@import
エイリアスと URL の結合も Sass ファイルと Less ファイルでサポートされています (詳しくはこちら CSS Pre-processors)。
PostCSS
もしプロジェクトに有効な PostCSS が含まれている場合 (postcss-load-config でサポートされている任意の形式、例: postcss.config.js
)、インポートされたすべての CSS に自動的に適用されます。
CSS Modules
.module.css
で終わる全ての CSS ファイルは全て CSS modules file とみなされます。このようなファイルをインポートすると、対応するモジュールオブジェクトが返されます:
/* example.module.css */
.red {
color: red;
}
import classes from './example.module.css'
document.getElementById('foo').className = classes.red
CSS モジュールの動作は css.modules
オプション を参考にしてください。
css.modules.localsConvention
がキャメルケースローカルを有効にするように設定されている場合(例:localsConvention: 'camelCaseOnly'
)、名前付きインポートを使用することもできます:
// .apply-color -> applyColor
import { applyColor } from './example.module.css'
document.getElementById('foo').className = applyColor
CSS プリプロセッサ
Vite は最新のブラウザのみを対象としているため、CSSWG ドラフト(postcss-nesting など)を実装する PostCSS プラグインでネイティブ CSS 変数を使用し、将来の標準に準拠したプレーンな CSS を作成することをお勧めします。
とは言うものの、Vite は .scss
、.sass
、.less
、.styl
、.stylus
ファイルの組み込みサポートを提供します。それらに Vite 固有のプラグインをインストールする必要はありませんが、対応するプリプロセッサ自体をインストールする必要があります。
# .scss and .sass
npm add -D sass
# .less
npm add -D less
# .styl and .stylus
npm add -D stylus
もし Vue で単一ファイルコンポーネントを使用している場合、これにより、<style lang="sass">
なども自動的に有効になります。
Vite は、Sass および Less の @import
解決を改善し、Vite エイリアスも尊重されるようにします。さらに、ルートファイルとは異なるディレクトリにあるインポートされた Sass / Less ファイル内の相対的な url()
の参照も、正確性を確保するために自動的に結合されます。
@import
エイリアスと URL の結合は、API の制約のため、Stylus ではサポートされていません。
ファイル拡張子の前に .module
を付けることで、プリプロセッサと組み合わせて CSS モジュールを使用することもできます(例:style.module.scss
)。
静的なアセット
静的アセットをインポートすると、提供時に解決されたパブリック URL が返されます:
import imgUrl from './img.png'
document.getElementById('hero-img').src = imgUrl
特別なクエリにより、アセットの読み込み方法を変更できます:
// アセットを URL として明示的にロードする
import assetAsURL from './asset.js?url'
// アセットを文字列として明示的にロードする
import assetAsString from './shader.glsl?raw'
// Web ワーカをロードする
import Worker from './worker.js?worker'
// ビルド時に base64 文字列としてインライン化された Web ワーカ
import InlineWorker from './worker.js?worker&inline'
詳しくは 静的アセットの取り扱い を見てください。
JSON
JSON ファイルは直接インポートできます - また、名前付きインポートもサポートされています::
// オブジェクト全体をインポートする場合
import json from './example.json'
// 名前付きエクスポートとしてルートフィールドをインポートします - ツリーシェイクに役立ちます!
import { field } from './example.json'
Glob のインポート
Vite は、特別な import.
関数を介してファイルシステムから複数のモジュールをインポートすることをサポートしています:
const modules = import.meta.glob('./dir/*.js')
上のコードは以下のように変換されます:
// vite によって生成されたコード
const modules = {
'./dir/foo.js': () => import('./dir/foo.js'),
'./dir/bar.js': () => import('./dir/bar.js')
}
次に、modules
オブジェクトのキーを繰り返し処理して、対応するモジュールにアクセスできます:
for (const path in modules) {
modules[path]().then((mod) => {
console.log(path, mod)
})
}
一致したファイルはデフォルトで動的インポートを介して遅延ロードされ、ビルド中に個別のチャンクに分割されます。もしあなたがすべてのモジュールを直接インポートする場合(たとえば、最初に適用されるこれらのモジュールの副作用に依存する場合)、代わりに import.
を使用できます:
const modules = import.meta.globEager('./dir/*.js')
上のコードは以下のように変換されます:
// vite によって生成されたコード
import * as __glob__0_0 from './dir/foo.js'
import * as __glob__0_1 from './dir/bar.js'
const modules = {
'./dir/foo.js': __glob__0_0,
'./dir/bar.js': __glob__0_1
}
import.
と import.
はアセットを文字列としてインポートすると同じようにファイルを文字列としてインポートすることもサポートしています。ここでは Import Assertions 構文を使ってインポートします。
const modules = import.meta.glob('./dir/*.js', { assert: { type: 'raw' } })
上のコードは以下のように変換されます:
// vite によって生成されたコード
const modules = {
'./dir/foo.js': '{\n "msg": "foo"\n}\n',
'./dir/bar.js': '{\n "msg": "bar"\n}\n'
}
注意点:
- これは Vite のみの機能で、Web または ES の標準ではありません。
- Glob パターンはインポート指定子のように扱われます。相対パス(
./
で始まる)または絶対パス(/
で始まり、プロジェクトルートに対して解決される)のいずれかでなければなりません。 - Glob のマッチングは
fast-glob
を介して行われます。サポートされている Glob パターンについては、そのドキュメントを確認してください。 - また、glob インポートは変数を受け付けないので、文字列のパターンを直接渡す必要があることにも注意が必要です。
- Glob パターンは外側の引用符と同じ引用符の文字列(つまり
'
,"
,`
)を含むことはできません。例えば'/Tom\'s files/**'
は、代わりに"/Tom's files/**"
を使用してください。
WebAssembly
プリコンパイルされた .wasm
ファイルは直接インポートできます - デフォルトのエクスポートは、wasm インスタンスの exports オブジェクトの Promise を返す初期化関数になります:
import init from './example.wasm'
init().then((exports) => {
exports.test()
})
init 関数は、第 2 引数として WebAssembly.instantiate
に渡される imports
オブジェクトを受け取ることもできます:
init({
imports: {
someFunc: () => {
/* ... */
}
}
}).then(() => {
/* ... */
})
本番ビルドでは、assetInlineLimit
よりも小さい .wasm
ファイルが base64 文字列としてインライン化されます。それ以外の場合は、アセットとして dist ディレクトリにコピーされ、オンデマンドでフェッチされます。
Web Workers
コンストラクタによるインポート
ワーカスクリプトは new Worker()
や new SharedWorker()
を使用することでインポートできます。サフィックスによるインポートと比べ、より標準的で推奨されるワーカ作成方法となります。
const worker = new Worker(new URL('./worker.js', import.meta.url))
ワーカコンストラクタはオプションを受け取り、「モジュール」ワーカとして作成することも可能です:
const worker = new Worker(new URL('./worker.js', import.meta.url), {
type: 'module'
})
クエリサフィックスによるインポート
インポートリクエストに ?worker
もしくは ?sharedworker
を追加することで、Web ワーカスクリプトを直接インポートできます。デフォルトのエクスポートはカスタムワーカコンストラクタになります:
import MyWorker from './worker?worker'
const worker = new MyWorker()
ワーカスクリプトは、importScripts()
の代わりに import
ステートメントを使用することもできます - この機能は現在開発中で、ブラウザのネイティブサポートに依存し、現在 Chrome でのみ機能しますが、本番ビルドではコンパイルされます。
デフォルトでは、ワーカスクリプトは本番ビルドで個別のチャンクとして出力されます。ワーカを base64 文字列としてインライン化する場合は、inline
クエリを追加します:
import MyWorker from './worker?worker&inline'
すべてのワーカをバンドルする設定についての詳細は Worker Options を見てください。
ビルドの最適化
以下にリストされている機能は、ビルドプロセスの一部として自動的に適用され、無効にする場合を除いて、明示的に構成する必要はありません。
CSS のコード分割
Vite は、非同期チャンク内のモジュールによって使用される CSS を自動的に抽出し、そのための個別のファイルを生成します。CSS ファイルは、関連付けられた非同期チャンクが読み込まれるときに <link>
タグを介して自動的に読み込まれ、FOUC を回避するために、CSS が読み込まれた後にのみ非同期チャンクが評価されることが保証されます。
もしすべての CSS を 1 つのファイルに抽出したい場合は、build.cssCodeSplit
を false
に設定することで、CSS コードの分割を無効にできます。
プリロードディレクティブの生成
Vite は、エントリチャンクとビルドされた HTML への直接インポート用の <link rel="modulepreload">
ディレクティブを自動的に生成します。
非同期チャンク読み込みの最適化
実際のアプリケーションでは、Rollup は「共通の」チャンク(2 つ以上の他のチャンク間で共有されるコード)を生成することがよくあります。動的インポートと組み合わせると、次のシナリオが発生するのが非常に一般的です。
最適化されていないシナリオでは、非同期チャンク A
がインポートされると、ブラウザは、共通チャンク C
も必要と判断する前に、A
を要求して解析する必要があります。これにより、余分なネットワークラウンドトリップが発生します。
Entry ---> A ---> C
Vite は、プリロードステップを使用してコード分割動的インポート呼び出しを自動的に書き換え、A
が要求されたときに、C
が並列にフェッチされるようにします:
Entry ---> (A + C)
これは C
がさらにインポートする可能性があり、最適化されていないシナリオではさらに多くのラウンドトリップが発生します。Vite の最適化は、すべての直接インポートをトレースして、インポートの深さに関係なく、ラウンドトリップを完全に排除します。