build-plugin-speed

1.0.1 verified Sat Apr 25 auth: no javascript

A build-scripts plugin that logs build time information for ice.js projects. Current stable version is 1.0.1. Released as part of the Alibaba ice framework ecosystem. It is a minimal plugin that outputs build speed metrics to the console during development and production builds. Differentiators: simple integration with ice.js build-scripts, no external dependencies.

Common errors

error Error: Cannot find module 'build-plugin-speed' ↓

cause Package not installed or incorrectly imported.

fix

Run npm install build-plugin-speed --save-dev and ensure the import path is correct.

error TypeError: buildPluginSpeed is not a function ↓

cause Using default import but package exports an object instead of a function.

fix

Ensure the default export is invoked as buildPluginSpeed() in the plugins array.

error Plugin 'build-plugin-speed' does not exist or is invalid ↓

cause Plugin name mismatch or wrong format in plugins array.

fix

Use the exact package name 'build-plugin-speed' (string) or the imported function.

Warnings

gotcha Plugin name must be exactly 'build-plugin-speed' in the plugins array; mismatched casing will silently fail. ↓

fix Ensure the import matches the package name exactly.

deprecated The package is marked as deprecated; consider using @ice/plugin-speed instead. ↓

fix Migrate to @ice/plugin-speed following the ice v3 upgrade guide.

gotcha Plugin only works with build-scripts v2.x and above; older versions will not load it. ↓

fix Update build-scripts to version 2.0.0 or higher.

Install

npm install build-plugin-speed

yarn add build-plugin-speed

pnpm add build-plugin-speed

Imports

default
```
import buildPluginSpeed from 'build-plugin-speed'
```
Default export is the plugin function. Expected to be used in build.config.js or ice.config.mts.

default (require)

wrong

const buildPluginSpeed = require('build-plugin-speed').default

correct

const buildPluginSpeed = require('build-plugin-speed')

CJS usage: the package provides a CommonJS entry; no .default needed.

Plugin type
```
import type { IPlugin } from 'build-scripts'
```
Type imports should come from build-scripts, not from this plugin.

Quickstart

Shows how to add the build-plugin-speed plugin to an ice.js project's build config.

// ice.config.mts or build.config.js
import buildPluginSpeed from 'build-plugin-speed';

export default defineConfig({
  plugins: [
    buildPluginSpeed()
  ]
});