Configuration

இந்தப் பக்கம் React Compiler-இல் கிடைக்கும் அனைத்து configuration options-ஐ பட்டியலிடுகிறது.

Note

பெரும்பாலான apps-க்கு default options எந்த கூடுதல் அமைப்புமின்றி வேலை செய்ய வேண்டும். உங்களுக்கு சிறப்பு தேவை இருந்தால், இந்த advanced options-ஐப் பயன்படுத்தலாம்.

// babel.config.js
module.exports = {
plugins: [
[
'babel-plugin-react-compiler', {
// compiler options
}
]
]
};

Compilation கட்டுப்பாடு

Compiler எதை optimize செய்கிறது மற்றும் compile செய்ய வேண்டிய components, hooks-ஐ எப்படி தேர்வு செய்கிறது என்பதை இந்த options கட்டுப்படுத்துகின்றன.

  • compilationMode compile செய்ய வேண்டிய functions-ஐத் தேர்வு செய்யும் strategy-ஐ கட்டுப்படுத்துகிறது (எ.கா. அனைத்து functions, annotated functions மட்டும், அல்லது intelligent detection).
{
compilationMode: 'annotation' // "use memo" functions மட்டும் compile செய்யவும்
}

Version compatibility

React version configuration, compiler உங்கள் React version-க்கு compatible ஆன code-ஐ உருவாக்குவதை உறுதிசெய்கிறது.

நீங்கள் எந்த React version-ஐப் பயன்படுத்துகிறீர்கள் (17, 18, அல்லது 19) என்பதை target குறிப்பிடுகிறது.

// For React 18 projects
{
target: '18' // react-compiler-runtime package-உம் தேவை
}

Error handling

Rules of React-ஐப் பின்பற்றாத code-க்கு compiler எவ்வாறு பதிலளிக்க வேண்டும் என்பதை இந்த options கட்டுப்படுத்துகின்றன.

Build-ஐ fail செய்ய வேண்டுமா அல்லது பிரச்சினையான components-ஐ skip செய்ய வேண்டுமா என்பதை panicThreshold தீர்மானிக்கிறது.

// Recommended for production
{
panicThreshold: 'none' // Build-ஐ fail செய்யாமல் errors உள்ள components-ஐ skip செய்யவும்
}

Debugging

Compiler என்ன செய்கிறது என்பதைப் புரிந்துகொள்ள logging மற்றும் analysis options உதவுகின்றன.

Compilation events-க்கு logger custom logging வழங்குகிறது.

{
logger: {
logEvent(filename, event) {
if (event.kind === 'CompileSuccess') {
console.log('Compiled:', filename);
}
}
}
}

Feature flags

Optimized code எப்போது பயன்படுத்தப்பட வேண்டும் என்பதை conditional compilation மூலம் கட்டுப்படுத்தலாம்.

A/B testing அல்லது gradual rollouts-க்கு gating runtime feature flags-ஐ enable செய்கிறது.

{
gating: {
source: 'my-feature-flags',
importSpecifierName: 'isCompilerEnabled'
}
}

பொதுவான configuration patterns

Default configuration

பெரும்பாலான React 19 applications-இல் compiler configuration இல்லாமலே வேலை செய்கிறது:

// babel.config.js
module.exports = {
plugins: [
'babel-plugin-react-compiler'
]
};

React 17/18 projects

பழைய React versions-க்கு runtime package மற்றும் target configuration தேவை:

npm install react-compiler-runtime@latest
{
target: '18' // அல்லது '17'
}

படிப்படியான adoption

குறிப்பிட்ட directories-இல் தொடங்கி, படிப்படியாக விரிவாக்குங்கள்:

{
compilationMode: 'annotation' // "use memo" functions மட்டும் compile செய்யவும்
}