Typing assist causes errors

Author: tumbislavCreated Mar 10, 2026Updated Mar 10, 2026

Scenario

In the Components/Schemas section of an OAS, take an existing object and add an attribute:

  • Move to the end of the object definition
  • Press Enter to get a new line and shift-Tab to outdent from the previous field.
  • Enter the field name newField: and Enter.
  • Enter type: string. The editor pops up a list of available types. The first type is array and it's pre-selected.
  • Press Enter. The editor replaces string with array

Result

There is a semantic error in the OAS.

This is one example. Other typing assist functions can be either annoying or harmful.

Workaround

Yes, by explicitly cancelling the autocomplete every single time.

Suggestion

Make all typing assist functions optional, so that the user can switch them all off with one button.

Source: swagger-api/swagger-editor