unplugin-check-syntax

یک افزونه بررسی نحوی عمومی که از ابزارهای ساخت مختلف (Webpack، Vite، Rollup، esbuild، Rspack و غیره) پشتیبانی می‌کند و برای بررسی سازگاری نحوی ECMAScript در فایل‌های JavaScript و HTML کاربرد دارد. این افزونه با الهام از rsbuild-plugin-check-syntax توسعه یافته است.

ویژگی‌ها

• 🔧 پشتیبانی از چند ابزار ساخت: پشتیبانی از Webpack، Vite، Rollup، esbuild، Rspack و غیره
• 📝 پشتیبانی از انواع فایل‌ها: پشتیبانی از فایل‌های JavaScript و اسکریپت‌های درون‌خطی در فایل‌های HTML
• 🎯 موقعیت‌یابی دقیق: پشتیبانی از sourcemap و امکان ردیابی به موقعیت فایل منبع
• ⚙️ پیکربندی انعطاف‌پذیر: پشتیبانی از حذف فایل‌ها، درج دستی، فیلتر خطاها و سایر گزینه‌ها
• 📁 کشف هوشمند فایل: پشتیبانی از الگوی glob برای درج دستی فایل‌های JS/HTML اضافی
• 🌐 یکپارچه‌سازی با Browserslist: پشتیبانی از تبدیل خودکار تنظیمات browserslist به نسخه ECMAScript

نصب

npm install @winner-fed/unplugin-check-syntax --save-dev

روش استفاده

Vite

// vite.config.ts
import { defineConfig } from 'vite'
import checkSyntax from '@winner-fed/unplugin-check-syntax/vite'
export default defineConfig({
  plugins: [
    checkSyntax({
      targets: ['> 1%', 'last 2 versions'],
      // 或者直接指定 ECMAScript 版本
      // ecmaVersion: 'es2015'
    }),
  ],
})

وب‌پک

// webpack.config.js
const checkSyntax = require('@winner-fed/unplugin-check-syntax/webpack')
module.exports = {
  plugins: [
    checkSyntax({
      targets: ['> 1%', 'last 2 versions'],
    }),
  ],
}

رول‌آپ

// rollup.config.js
import checkSyntax from '@winner-fed/unplugin-check-syntax/rollup'
export default {
  plugins: [
    checkSyntax({
      targets: ['> 1%', 'last 2 versions'],
    }),
  ],
}

اس‌بیلد

// esbuild.config.js
const { build } = require('esbuild')
const checkSyntax = require('@winner-fed/unplugin-check-syntax/esbuild')
build({
  plugins: [
    checkSyntax({
      targets: ['> 1%', 'last 2 versions'],
    }),
  ],
})

رس‌پک

// rspack.config.js
const checkSyntax = require('@winner-fed/unplugin-check-syntax/rspack')
module.exports = {
  plugins: [
    checkSyntax({
      targets: ['> 1%', 'last 2 versions'],
    }),
  ],
}

گزینه‌های پیکربندی

interface CheckSyntaxOptions {
  /
   
目标浏览器范围，使用 browserslist 格式
   
*/
  targets?: string[];
  
  /
   
直接指定 ECMAScript 版本（优先级高于 targets）
   
*/
  ecmaVersion?: 'es3' | 'es5' | 'es2015' | 'es2016' | 'es2017' | 'es2018' | 'es2019' | 'es2020' | 'es2021' | 'es2022' | 'latest';
  
  /
   
排除源文件检查，支持正则表达式
   
*/
  exclude?: RegExp | RegExp[];
  
  /
   
排除输出文件检查，支持正则表达式  
   
*/
  excludeOutput?: RegExp | RegExp[];
  
  /
   
手动包含额外的 JS 或 HTML 文件进行语法检查
   
支持文件路径（相对于项目根目录）或 glob 模式
   
*/
  include?: string[];
  
  /
   
排除特定的错误日志类型
   
*/
  excludeErrorLogs?: ('source' | 'output' | 'reason' | 'code')[];
}

نمونه استفاده

پیکربندی پایه

// 使用 browserslist 配置
checkSyntax({
  targets: ['> 1%', 'last 2 versions', 'not dead'],
})
// 直接指定 ECMAScript 版本
checkSyntax({
  ecmaVersion: 'es2015',
})

فایل‌های مستثنی شده

checkSyntax({
  targets: ['> 1%', 'last 2 versions'],
  // 排除 node_modules 和测试文件
  exclude: [/node_modules/, /\.test\.js$/],
  // 排除特定输出文件
  excludeOutput: [/vendor\.js$/],
})

شامل کردن فایل‌های اضافی

checkSyntax({
  targets: ['> 1%', 'last 2 versions'],
  // 手动包含额外的文件进行检查
  include: [
    'src/legacy//*.js',        // 包含 legacy 目录下的所有 JS 文件
    'public/scripts/app.js',     // 包含特定的公共脚本文件
    'docs//*.html',            // 包含文档中的 HTML 文件
    '/absolute/path/to/file.js'  // 支持绝对路径
  ],
})

خروجی خطای سفارشی

checkSyntax({
  targets: ['> 1%', 'last 2 versions'],
  // 只显示错误原因，不显示代码片段
  excludeErrorLogs: ['code', 'output'],
})

راهنمای مهاجرت

اگر در حال مهاجرت از @rsbuild/plugin-check-syntax هستید:

- import { pluginCheckSyntax } from '@rsbuild/plugin-check-syntax'
+ import checkSyntax from '@winner-fed/unplugin-check-syntax/vite' // 或其他构建工具
export default defineConfig({
  plugins: [
  pluginCheckSyntax({
+   checkSyntax({
      targets: ['> 1%', 'last 2 versions'],
    }),
  ],
})

نحوه کار

• بررسی پس از ساخت: افزونه پس از اتمام ساخت، فایل‌های خروجی را بررسی می‌کند
• تجزیه نحوی: با استفاده از تجزیه‌گر Acorn، نحو جاوااسکریپت را بررسی می‌کند
• اعتبارسنجی سازگاری: بر اساس نسخه ECMAScript پیکربندی‌شده، سازگاری نحوی را اعتبارسنجی می‌کند
• گزارش خطا: اطلاعات دقیقی از خطاها، شامل موقعیت فایل و قطعه‌ای از کد منبع ارائه می‌دهد
• پشتیبانی از سورس‌مپ: اگر sourcemap وجود داشته باشد، تا فایل منبع اصلی ردیابی می‌کند

مجوز

مجوز MIT

مشارکت

ارسال Issue و Pull Request خوش‌آمد گفته می‌شود!

--- Tranlated By Open Ai Tx | Last indexed: 2025-07-21 ---