prefer-dom-node-text-content

Prefer textContent over innerText. This rule is part of eslint-plugin-conventions.

Quick SummaryCopy Anchor Link

Rule DetailsCopy Anchor Link

innerText triggers reflow and is slower. textContent is more performant and works in all contexts.

The rule reports reading or writing innerText in every spelling: el.innerText, el['innerText'], el?.innerText, an assignment target, and destructuring it (const { innerText } = el, renamed too). It does not report textContent, a runtime key (el[key]), an innerText key in an object literal (it builds an object; no element is touched) or a variable named innerText. The suggestion rewrites member accesses; destructuring gets no suggestion, because renaming the key would rename the binding too.

Why This MattersCopy Anchor Link

ExamplesCopy Anchor Link

❌ IncorrectCopy Anchor Link

const text = element.innerText;  // Triggers reflow
element.innerText = 'Hello';  // Slower

✅ CorrectCopy Anchor Link

const text = element.textContent;  // No reflow
element.textContent = 'Hello';  // Faster

// Use innerText only when you need style-aware text
// (hidden elements, CSS text-transform, etc.)

Configuration ExamplesCopy Anchor Link

Basic UsageCopy Anchor Link

{
  rules: {
    'conventions/prefer-dom-node-text-content': 'warn'
  }
}

Related RulesCopy Anchor Link

• prefer-code-point - Unicode handling

Further ReadingCopy Anchor Link

• textContent - MDN - MDN reference
• Difference between textContent and innerText - Comparison

Known False NegativesCopy Anchor Link

• The rule is not type-aware: it does not check that the receiver is a DOM element, so a non-DOM object with an innerText property is reported too, and an element reached through Reflect.get(el, 'innerText') is not.

Use this rule

npm install -D oxlint-plugin-conventions

{  "jsPlugins": ["oxlint-plugin-conventions"],  "rules": {    "conventions/prefer-dom-node-text-content": "error"  }}

import { defineConfig } from 'vite-plus';export default defineConfig({  lint: {    jsPlugins: ['oxlint-plugin-conventions'],    rules: {      'conventions/prefer-dom-node-text-content': 'error',    },  },});