Swagger page failing to load for API endpoints with large JSON responses

[VarunReddy1111]

Example Swagger/OpenAPI definition:
openapi.yaml.zip

I am using Quarkus 3.5.0 (OpenAPI 3.0.3) embedded swagger, When dealing with API endpoints, due to large json response that gets populated in example schema section, the UI is crashing. Attaching the openapi definition. Please let me know if any other information is needed.

[glowcloud]

Related to #3832

The current known workaround is using this setting:

    syntaxHighlight: {
      activated: false,
      theme: "agate"
    }

It seems like it's not enough in this case - the examples will sometimes load after hanging and sometimes still crash the browser.

There is a PR #9625 addressing this issue, I'll take a look at it next.

[glowcloud]

I will be tracking this further in the related issue #3832.

[heldersepu]

NO PR #9625 is not addressing this issue
... and this issue is not related to issue #3832

[heldersepu]

The schema in the given openapi.yaml.zip is massive!!
once unpacked that is 2.5MB

this is not about "large JSON responses" heck with that schema the UI crashes even without making any requests

Just expanding the "put_api_agm_disease_annotation" crashes, there was no large response because we did not make any request, the [Try it out] button did not even show, you can test it here:
https://petstore.swagger.io/?docExpansion=None&defaultModelsExpandDepth=None&url=https://gist.githubusercontent.com/heldersepu/ab37902d2f687d2c71aa1b36bb72ee48/raw/0f68906074dfbad5528a81132ae7975b6bf2ef75/openapi.yml#/CRUD%20-%20AGM%20Disease%20Annotations

the problem on issue 3832 is an actual large response from the API, in that case the syntax highlighter takes too long to render and browsers crashes

[VarunReddy1111]

Thank you for the response @heldersepu. Yes, the swagger ui crashing while expanding the end point. Is this because of massive openAPI file? and do you have any resolution for this issue?

[heldersepu]

This issue is closer in relation to issue 4411, see my comment there:

#4411 (comment)

The expansion of a truly complex object creates a LOT of code, the browser will ultimately crash and burn

The problem presented on this issue I would put this schema on the "huge and extra complex" category, it has 84962 lines, that is mind blowing for an API description ... everyone is moving toward micro-service architectures but it looks like this is the opposite movement

[heldersepu]

Thank you for the response @heldersepu. Yes, the swagger ui crashing while expanding the end point. Is this because of massive openAPI file? and do you have any resolution for this issue?

Sorry but no resolution or even a workaround, and no the syntaxHighlight deactivation is not a workaround for this ...
if that is the schema your team wants to use, then Swagger-UI is not the tool for you...

have you heard that saying:
"when you are a hammer everything is a nail"

quite often we developers fall in that trap...
yes we can use a hammer to cut down a tree, but that is not the right tool.

My recommendation: refactor your code, move to a micro-service architecture

[heldersepu]

If we want to keep this open for someone to investigate ...
here is small schema but with nested definitions that causes the same crash:

https://petstore.swagger.io/?url=https://raw.githubusercontent.com/heldersepu/hs-scripts/master/swagger/NestedSwag.json