Skip to content

fix(params): display const value in parameter description and Try It form#1367

Merged
sserrata merged 1 commit intomainfrom
fix/const-param-value
Mar 30, 2026
Merged

fix(params): display const value in parameter description and Try It form#1367
sserrata merged 1 commit intomainfrom
fix/const-param-value

Conversation

@sserrata
Copy link
Copy Markdown
Member

Summary

OAS 3.1 allows const on parameter schemas to define a single acceptable value. This was silently ignored — no value shown in the docs, and a free-form text input shown in the Try It panel.

  • ParamsItem: adds renderConstValue() showing Constant value: <X> in the parameter description, mirroring the pattern already used in SchemaItem and reusing the existing CONSTANT_VALUE translation ID
  • getSchemaEnum: treats schema.const as a single-element enum, so const parameters naturally route to the existing ParamSelectFormItem dropdown (with --- and the const value as options) instead of a free-form text input

Test plan

  • A parameter with schema: { type: string, const: CONFIG } shows Constant value: CONFIG in the description area
  • The same parameter shows a dropdown in Try It with two options: --- and CONFIG
  • Parameters with enum are unaffected
  • Non-string const values (e.g. const: 42) render correctly via JSON.stringify

Closes #1307

🤖 Generated with Claude Code

…form

- ParamsItem now renders "Constant value: <X>" for parameters whose schema
  uses const, reusing the existing CONSTANT_VALUE translation ID
- getSchemaEnum now treats schema.const as a single-value enum, routing
  const parameters to the existing ParamSelectFormItem dropdown instead
  of a free-form text input

Closes #1307
@github-actions
Copy link
Copy Markdown

Size Change: 0 B

Total Size: 2.21 MB

ℹ️ View Unchanged
Filename Size
demo/.docusaurus/codeTranslations.json 2 B
demo/.docusaurus/docusaurus.config.mjs 14.7 kB
demo/.docusaurus/globalData.json 66.5 kB
demo/.docusaurus/i18n.json 372 B
demo/.docusaurus/registry.js 96.4 kB
demo/.docusaurus/routes.js 91.1 kB
demo/.docusaurus/routesChunkNames.json 37.8 kB
demo/.docusaurus/site-metadata.json 1.51 kB
demo/build/assets/css/styles.********.css 164 kB
demo/build/assets/js/main.********.js 659 kB
demo/build/assets/js/runtime~main.********.js 22.6 kB
demo/build/index.html 97.6 kB
demo/build/petstore/add-pet/index.html 29.3 kB
demo/build/petstore/create-user/index.html 24 kB
demo/build/petstore/create-users-with-array-input/index.html 24.1 kB
demo/build/petstore/create-users-with-list-input/index.html 24.1 kB
demo/build/petstore/delete-order/index.html 23.8 kB
demo/build/petstore/delete-pet/index.html 24.1 kB
demo/build/petstore/delete-user/index.html 24.3 kB
demo/build/petstore/find-pets-by-status/index.html 24.8 kB
demo/build/petstore/find-pets-by-tags/index.html 25.4 kB
demo/build/petstore/get-inventory/index.html 23.1 kB
demo/build/petstore/get-order-by-id/index.html 24.1 kB
demo/build/petstore/get-pet-by-id/index.html 24.9 kB
demo/build/petstore/get-user-by-name/index.html 24.4 kB
demo/build/petstore/login-user/index.html 24.9 kB
demo/build/petstore/logout-user/index.html 23.7 kB
demo/build/petstore/new-pet/index.html 24.3 kB
demo/build/petstore/pet/index.html 22.5 kB
demo/build/petstore/place-order/index.html 23.3 kB
demo/build/petstore/schemas/apiresponse/index.html 24.6 kB
demo/build/petstore/schemas/cat/index.html 38.7 kB
demo/build/petstore/schemas/category/index.html 25.7 kB
demo/build/petstore/schemas/dog/index.html 39 kB
demo/build/petstore/schemas/honeybee/index.html 39.1 kB
demo/build/petstore/schemas/id/index.html 22.7 kB
demo/build/petstore/schemas/order/index.html 26.8 kB
demo/build/petstore/schemas/pet/index.html 38.5 kB
demo/build/petstore/schemas/tag/index.html 24.1 kB
demo/build/petstore/schemas/user/index.html 40.6 kB
demo/build/petstore/store/index.html 21.5 kB
demo/build/petstore/subscribe-to-the-store-events/index.html 30.2 kB
demo/build/petstore/swagger-petstore-yaml/index.html 30.2 kB
demo/build/petstore/update-pet-with-form/index.html 24.3 kB
demo/build/petstore/update-pet/index.html 24.7 kB
demo/build/petstore/update-user/index.html 24.3 kB
demo/build/petstore/upload-file/index.html 24.1 kB
demo/build/petstore/user/index.html 22.2 kB

compressed-size-action

@github-actions
Copy link
Copy Markdown

Visit the preview URL for this PR (updated for commit 2203abf):

https://docusaurus-openapi-36b86--pr1367-vbry400h.web.app

(expires Wed, 29 Apr 2026 19:25:51 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: bf293780ee827f578864d92193b8c2866acd459f

@sserrata sserrata merged commit 21e6ede into main Mar 30, 2026
11 checks passed
@sserrata sserrata deleted the fix/const-param-value branch March 30, 2026 19:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

const parameter value is not displayed

1 participant