ES Version Plugin

Overview

The ES Version plugin is Fast Brake’s core plugin for detecting ECMAScript features across all major JavaScript versions from ES5 to ES2025. It provides comprehensive coverage of 40+ JavaScript features with optimized pattern matching.

Installation & Import

import { es5, es2015, es2020, esAll } from 'fast-brake/src/plugins/esversion';

// Use specific version checks
const plugin = es2015; // Detects features from ES2015 and later

// Or use the complete plugin
const allFeatures = esAll; // Detects all ES features

Available Exports

• es5 - Detects features from ES5 and later
• es2015 (ES6) - Detects features from ES2015 and later
• es2016 - Detects features from ES2016 and later
• es2017 - Detects features from ES2017 and later
• es2018 - Detects features from ES2018 and later
• es2019 - Detects features from ES2019 and later
• es2020 - Detects features from ES2020 and later
• es2021 - Detects features from ES2021 and later
• es2022 - Detects features from ES2022 and later
• es2023 - Detects features from ES2023 and later
• es2024 - Detects features from ES2024 and later
• es2025 - Detects features from ES2025 and later
• esAll - Detects all ES features

Detected Features by Version

ES2015 (ES6)

ES2016

ES2017

ES2018

ES2019

ES2020

ES2021

ES2022

ES2023

ES2024

ES2025

Usage Examples

Basic Detection

import { detect } from 'fast-brake';
import { es2015 } from 'fast-brake/src/plugins/esversion';

const detector = new Detector({ plugins: [es2015] });
await detector.initialize();

const code = `
  const arrow = () => {};
  class MyClass {}
  const template = \`Hello World\`;
`;

const features = await detector.detect(code);
console.log(features);
// [
//   { name: 'arrow_functions', version: 'es2015' },
//   { name: 'classes', version: 'es2015' },
//   { name: 'template_literals', version: 'es2015' }
// ]

Target Version Checking

import { check } from 'fast-brake';

// Check if code is ES5 compatible
const isES5 = await check(code, { target: 'es5' });

// Check if code is ES2015 compatible
const isES2015 = await check(code, { target: 'es2015' });

Minimum Version Detection

import { getMinimumESVersion } from 'fast-brake';

const code = `
  const x = async () => {
    await fetch('/api');
  };
`;

const minVersion = getMinimumESVersion(code);
console.log(minVersion); // 'es2017' (async/await)

Performance Tips

Use Specific Version Plugins

For better performance, use the most specific plugin for your needs:

// If you only need to check ES2020+ features
import { es2020 } from 'fast-brake/src/plugins/esversion';

// Instead of loading all features
import { esAll } from 'fast-brake/src/plugins/esversion';

Early Exit Strategy

Use throwOnFirst option for fastest compatibility checking:

import { fastBrake } from 'fast-brake';

try {
  await fastBrake(code, { 
    target: 'es2015', 
    throwOnFirst: true  // Stop on first incompatible feature
  });
} catch (error) {
  console.error('Incompatible feature found:', error.message);
}

Integration Examples

Build Tool Integration

// webpack.config.js
const { check } = require('fast-brake');

module.exports = {
  module: {
    rules: [{
      test: /\.js$/,
      use: async (source) => {
        if (!await check(source, { target: 'es2015' })) {
          // Needs transpilation
          return require('babel-loader')(source);
        }
        return source;
      }
    }]
  }
};

CI/CD Pipeline

// check-compatibility.js
import { fastBrake } from 'fast-brake';
import { readFileSync } from 'fs';
import { glob } from 'glob';

const files = glob.sync('src/**/*.js');
const target = process.env.ES_TARGET || 'es2018';

for (const file of files) {
  const code = readFileSync(file, 'utf-8');
  try {
    await fastBrake(code, { target });
    console.log(`✓ ${file}`);
  } catch (error) {
    console.error(`✗ ${file}: ${error.message}`);
    process.exit(1);
  }
}