W3cubDocs

/Flow

Error Suppressions

Flow reports many different kinds of errors for many common programming mistakes, but not every JavaScript pattern can be understood by Flow. If you are confident your code is correct, and that Flow is erroring too conservatively, you can suppress the error so that Flow does not report it.

What is a Suppression?

A suppression is a special kind of comment that you can place on the line before a type error. It tells Flow not to report that error when checking your code. Suppression comments look like the following:

// <SUPPRESSOR>[<CODE>] extra text

A suppressor can be one of the following:

  • $FlowFixMe: for type errors that you intend to fix later
  • $FlowIssue: for a type error that you suspect is an issue with Flow
  • $FlowExpectedError: for a location where you expect Flow to produce a type error (for instance, when performing an invalid type cast).
  • $FlowIgnore: for locations where you want Flow to ignore your code

Note that all of the suppressors behave identically; we simply recommend using them as described here for your own ease of reference.

The <CODE> portion of a suppression is optional, but when included specifies which error code the suppression affects.

Some examples of suppression comments:

// $FlowFixMe

// $FlowIssue[incompatible-type]

/* $FlowIgnore[prop-missing] some other text here */

/* $FlowFixMe[incompatible-cast] this
    is a multi-line
    comment */

{ /* $FlowIssue this is how you suppress errors inside JSX */ }

In order to be a valid suppression comment, there are also some conditions that must be true:

  • No text can precede the suppressor, or come between the suppressor and the code. For example: // some text then $FlowFixMe is not a valid suppression, nor is // $FlowIssue some text [incompatible-type] or ` //$FlowFixMe [prop-missing]` (note the space here!).
  • Suppressions must be on the line immediately before the error they suppress, otherwise they will not apply.

Making Suppressions More Granular with Error Codes

Suppressible Flow errors will also have an error code associated with them (after version 0.127). This code concisely describes the type of issue the error is reporting, and is different between different kinds of errors.

In order to prevent suppressions from suppressing different kinds of type errors on the same line (by default suppressions without codes suppress every error on the following line), you can add an error code to your suppression. For example: // $FlowFixMe[incompatible-type] would only suppress errors with the incompatible-type code. So:

//$FlowFixMe[incompatible-type]
(3 : string);

would report no errors, but

//$FlowFixMe[prop-missing]
(3 : string);

would still report a type incompatibility.

To suppress multiple error codes on the same line, you can stack suppression comments one after another, and they will all apply to the first non-comment line like so:

let y : number | { x : number }  = 1;

// $FlowFixMe[incompatible-type]
// $FlowFixMe[prop-missing]
(y.x : string);

This will suppress both of the two errors on this line.

© 2013–present Facebook Inc.
Licensed under the MIT License.
https://flow.org/en/docs/errors