microsoft / microsoft/TypeScript
Allow top-level await in namespaces
Open
Nobody has claimed this yet.
Awaiting More Feedback
Suggestion
- Dominant language
- Go
- Stars
- 111k
- Forks
- 14.3k
- Avg merge
- 1d 19h
- Merged PRs (30d)
- 117
Description
Suggestion
🔍 Search Terms
Top, level, await, namespace, export
✅ Viability Checklist
My suggestion meets these guidelines:
- This wouldn't be a breaking change in existing TypeScript/JavaScript code
- This wouldn't change the runtime behavior of existing JavaScript code
- This could be implemented without emitting different JS based on the types of the expressions
- This isn't a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, new syntax sugar for JS, etc.)
- This feature would agree with the rest of TypeScript's Design Goals.
⭐ Suggestion
Allow top-level await in namespaces.
Current behaviour:
// ok
await 1;
export namespace Example {
// not ok
await 1;
}
📃 Motivating Example
Current:
export const _keyValuePair = await idbKeyValuePair.load("name");
export namespace storage {
export const keyValuePair = _keyValuePair;
}
💻 Use Cases
export namespace storage {
export const keyValuePair = await idbKeyValuePair.load("name");
}
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
The issue names no repository files, tests, or entry points; begin by tracing the compiler handling of top-level await and namespace bodies. Use the provided namespace examples to define completion: await expressions inside namespaces should be accepted without changing existing JavaScript runtime behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, typescript
- Domain
- compilers
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100