Skip to content

[pull] master from koajs:master#153

Merged
pull[bot] merged 1 commit into
backup999:masterfrom
koajs:master
Jun 9, 2026
Merged

[pull] master from koajs:master#153
pull[bot] merged 1 commit into
backup999:masterfrom
koajs:master

Conversation

@pull

@pull pull Bot commented Jun 9, 2026

Copy link
Copy Markdown

See Commits and Changes for more details.


Created by pull[bot] (v2.0.0-alpha.4)

Can you help keep this open source service alive? 💖 Please sponsor : )

…o it) (#1978)

The `app.currentContext` example assigns to the property:

```js
function callSomeFunction () {
  app.currentContext = {} /* ctx of the middleware above */
}
```

But `currentContext` is a **getter-only** accessor
(`lib/application.js`):

```js
get currentContext () {
  if (this.ctxStorage) return this.ctxStorage.getStore()
}
```

There is no setter, so assigning to it throws `TypeError: Cannot set
property currentContext of #<Application> which has only a getter` in
strict mode (which is the default for ES modules / class bodies). The
assignment is also backwards from what the surrounding text describes —
"this will **return** the current context for the request" — so the
example should *read* the property, which is exactly what the adjacent
v3.1.0 example does via `asyncLocalStorage.getStore()`.

This changes the example to read the getter:

```js
function callSomeFunction () {
  const ctx = app.currentContext /* ctx of the middleware above */
}
```

Docs only.

## Summary by Sourcery

Documentation:
- Update the `app.currentContext` documentation example to read from the
getter instead of assigning to it.

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

## Release Notes

* **Documentation**
* Corrected example code in Koa v3 API documentation to properly
demonstrate context retrieval.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->
@pull pull Bot locked and limited conversation to collaborators Jun 9, 2026
@pull pull Bot added the ⤵️ pull label Jun 9, 2026
@pull pull Bot merged commit 78efdc8 into backup999:master Jun 9, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant