Skip to content

react/forward-ref-uses-ref Correctness ​

✅ This rule is turned on by default.
🚧 An auto-fix is still under development.

What it does ​

Requires that components wrapped with forwardRef must have a ref parameter. Omitting the ref argument is usually a bug, and components not using ref don't need to be wrapped by forwardRef.

Why is this bad? ​

Omitting the ref argument makes the forwardRef wrapper unnecessary, and can lead to confusion.

Examples ​

Examples of incorrect code for this rule:

jsx
var React = require("react");

var Component = React.forwardRef((props) => <div />);

Examples of correct code for this rule:

jsx
var React = require("react");

var Component = React.forwardRef((props, ref) => <div ref={ref} />);

var Component = React.forwardRef((props, ref) => <div />);

function Component(props) {
  return <div />;
}

How to use ​

To enable this rule in the CLI or using the config file, you can use:

bash
oxlint --deny react/forward-ref-uses-ref
json
{
  "rules": {
    "react/forward-ref-uses-ref": "error"
  }
}

References ​

Released under the MIT License.