BREAKING(yaml): replace YamlError with SyntaxError in parse()

[iuioiua]

What's changed

parse() now throws SyntaxError instead of YamlError. No changes in behavior have been made.

Motivation

This change was made to align @std/yaml with other parse() functions in the Standard Library, such as in @std/csv and @std/toml, and JSON.parse(), which all throw SyntaxError. This will also result in a slightly smaller API surface and allows the user to more easily differentiate between parse() and stringify() errors (stringify() will soon throw TypeError).

Migration guide

To migrate, compare against SyntaxError instead of YamlError when error-handling parse().

- import { parse, YamlError } from "@std/yaml/parse";
+ import { parse } from "@std/yaml/parse";

try {
  parse(`"`);
} catch (error) {
- if (error instanceof YamlError) {
+ if (error instanceof SyntaxError) {
    // ...
  }
}

Related

Towards #5340

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.35%. Comparing base (df388b1) to head (32c7472).

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5446      +/-   ##
==========================================
- Coverage   96.35%   96.35%   -0.01%     
==========================================
  Files         461      461              
  Lines       37762    37761       -1     
  Branches     5576     5576              
==========================================
- Hits        36385    36383       -2     
- Misses       1335     1336       +1     
  Partials       42       42              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[kt3k]

LGTM