stdlib-js / stdlib-js/stdlib

[RFC]: add `symbol/match`

Open
#8,478 2 comments 0 reactions 0 assignees View on GitHub
Accepted difficulty: 1 Feature Good First Issue JavaScript priority: Normal RFC
Dominant language
JavaScript
Stars
6k
Forks
1.3k
Avg merge
1d 3h
Merged PRs (30d)
611

Description

### Description

This RFC proposes adding the package `symbol/match`.

The package should be very similar to the following existing packages:

- `symbol/has-instance`
- `symbol/iterator`
- `symbol/async-iterator`
- `symbol/is-concat-spreadable`

The primary difference is that the package should export `Symbol.match` if it exists.

### Related Issues

None.

### Questions

No.

### Other

When adding this package, one should do the following:

- copy one of the existing packages mentioned above
- rename the copied package
- find and replace the package name (e.g., `has-instance` => `match`)
- find and replace the variable name (e.g., `HasInstanceSymbol` => `MatchSymbol`)
- ensure the copyright years are 2025
- update the descriptions according to the symbol's purpose (see MDN)
- update examples to reflect the symbol's purpose (see existing packages for inspiration)
- run tests, benchmarks, and examples to ensure that everything passes
- go back through and check that there are no copy-paste mistakes

### Checklist

- [x] I have read and understood the [Code of Conduct](https://github.com/stdlib-js/stdlib/blob/develop/CODE_OF_CONDUCT.md).
- [x] Searched for existing issues and pull requests.
- [x] The issue name begins with `RFC:`.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.