koajs / koa

Expressive middleware for node.js using ES2017 async functions
https://koajs.com
MIT License
35.11k stars 3.22k forks source link

Koa main website example code snippets disappear #1775

Closed sopwerdna closed 12 months ago

sopwerdna commented 1 year ago

Koa site has example code which renders for a split second, then disappears.

I double checked and could not find other discussion of this problem, or a better place to report it (the koajs/koajs.com repo seems to be the actual home of the website code but issues are closed on that repo). I hope this is a helpful report. Thanks!

Actual behavior

Open the main koa site and scroll down to "Application" then look under the line "The obligatory hello world application". Refresh the page and you will see the example code appear briefly then disappear again. The same occurs with the next example code snippet under "Cascading". This occurs for me on both firefox, safari, and chrome on macOS, although I don't have any other OSs handy to test.

Expected behavior

Example code/hello world is displayed normally

sopwerdna commented 1 year ago

Update: I was able to test with firefox on android, there it appears in plaintext, disappears, and then reappears a second or so later with full syntax highlighting in a Runkit widget. It seems like the problem on all desktop browsers is that the Runkit widget hides the original text but then fails to run and replace the plain text.

iwanofski commented 12 months ago

I've tested this on Safari, Chrome and Firefox on a Macbook and I've had no issues seeing the examples. Could this have been a temporary bug? Are you still missing the examples? Anyone else who can confirm the bug?

sopwerdna commented 12 months ago

Thanks - I think I've managed to confirm the problem is actually network related, with a corporate network firewall blocking websockets used by the Runkit widget (hence why it worked on my phone). Not sure why it needs a websocket connection to display code with syntax highlighting, or why the widget is hiding the plain text example code before successfully loading the enhanced code highlighting. Regardless, I think this is more a Runkit bug so I'll try to bring this to their attention. Apologies for the spurious bug report!

iwanofski commented 12 months ago

Not sure why it needs a websocket connection to display code with syntax highlighting, or why the widget is hiding the plain text example code before successfully loading the enhanced code highlighting

I wouldn't want to speculate on the "why" of how Runkit operates but to your question regarding replacing the example: I would imagine it's practical in case Runkit is down, the intended example still shows/exists on the page.