Possible fix for #5032: Don't hang forever on asset loading error by diarmidmackenzie · Pull Request #5033 · aframevr/aframe · GitHub

Description:

Currently, if a bad URL is specified for an asset, A-Frame just shows the loading screen indefinitely (regardless of the asset timeout configured).

This prevents applications from providing application-specific handling (e.g. their own error message) when this might happen.
(in terms of why this might happen, suppose the HTML content is generated by server-side rendering on a back-end, and a bug emerges in the backend).

Changes proposed:

Update a-node processing when awaiting all children loading, so that:

it acknowledges the possibility of errors, and handles them
goes ahead and declares items "loaded" so that the scene can render, even if there have been errors.

I also added a small example showing the problem:
/examples/test/gltf-model-error/

Not sure if you'll want this included as part of the PR, but it was handy for reproducing the problem & validating the fix.

Don't you think this can be misleading? Worried that we're masking errors that the dev might want to stop and fix and could go unnoticed.

There's already a console error about the failure to load a file.
So it didn't seem to me like another error was helpful, and a warning was the appropriate error level here.

Is there anything we can do apart from console warnings & errors to draw a Dev's attention to the fact that something is not right?

(apart from failing to render the scene at all, which as per #5032 I don't think that's a good solution).

I know it's misleading the test examples are not actually tests but simple examples that test very specific features. For this we should probably write a unit test

OK - I will have a go at a Unit Test.

Unit Tests now added.

Can we leave this in as well, or do you prefer me to delete it?

I would remove this so examples/test is consistent. It serves the purpose to test visually specific features. Your unit test handles the failure case.

OK - removed it.

Sorry for the slow progress on this.

I've now added some test cases.

It took me a long time to realize that Mocha is very sensitive to detecting unhandled errors, and will fail tests whenever your code emits an event named "error", and your test script does not immediately call done(), or stop event propagation.

The error message for this is rather opaque...

Error: [object CustomEvent] (undefined:undefined)

I have also adjusted the fix itself. Previously, as soon as a single faulty asset was found, it would jump into the scene. Now it proceeds with the rest of asset loading on the normal pattern, and logs warnings about the failed assets at the end.

I think that's better behaviour: as per the original issue, we want to mitigate the impact of one incorrect asset URL, but that doesn't mean we want to jump into rendering the scene before other, available, assets have had a chance to load.

I've left the gltf_model_error.html test file in for now, as I found it pretty useful while working on this, so it could be useful in future?

But happy to remove it if you prefer...

@dmarcos, with the UTs done, can this be merged now? Or are there other concerns to address?

@kylebakerio has reached out to ask whether I can push ahead and get this merged.

@dmarcos you should probably merge this first, then I will rebase #5123 to resolve a conflict.

@diarmidmackenzie can you please rebase your PR, you need to fix the conflict around evt.stopPropagation(); since #5123 was merged first.

@diarmidmackenzie can you please rebase your PR, you need to fix the conflict around evt.stopPropagation(); since #5123 was merged first.

Done.

This needs a rebase. Combing through open stuff to prep for a 1.4.0 release. Thanks for the patience

I believe this is now all up-to-date with latest master again.

A couple of conversation points where I'm not 100% sure whether you were happy with what I'd proposed or not..
#5033 (comment)
#5033 (comment)

Hmm - seing a test failure like this:
SUMMARY:
✔ 734 tests completed
ℹ 3 tests skipped
✖ 1 test failed

FAILED TESTS:
✖ "after each" hook for "does not try to enter VR if already in VR"

I'll look into it.

OK, I don't know why this test issue has only come to light now, but it is due to inadequate mocking of the canvas element.

This leads to an exception in the look-controls component when it tries to add to the canvas classList.

TypeError: Cannot read properties of undefined (reading 'add')
      at enableGrabCursor (build/commons.js:17060:32)
      at NewComponent.updateGrabCursor (build/commons.js:17074:7)
      at NewComponent.update (build/commons.js:16723:12)
      at NewComponent.initComponent (build/commons.js:26161:10)
      at NewComponent.updateProperties (build/commons.js:26130:12)
      at AEntity.updateComponent (build/commons.js:24971:17)
      at AEntity.updateComponents (build/commons.js:24948:12)
      at entityLoadCallback (build/commons.js:24739:12)
      at emitLoaded (build/commons.js:25673:9)

I believe the solution (which I've just added as a fix into this PR) is to extend the mock canvas object so that classList.add and classList.remove can be invoked without causing exceptions.

I don't have a good understanding of why this didn't cause problems prior to this fix, but the exception does occur in a loading callback, and we have made changes in the handling of such exceptions, so it's plausible that for some reason this exception didn't cause problems for the tests previously.

This particular failng test is not intended to test exceptions, and the intent of the test will be better met if we avoid these exceptions, which is what the extension to the canvas mock object achieves. So I think that is the correct fix, and I don't see any evidence of a problem in the code under test.

Vincent has made many changes asnd improvements to the tests in recent months, part of which allowed many tests that were being skipped to now be run. Could be related to that, I didn't look into those changes in too much detail.

Good catch and fix.

There is also an error on master with firefox related to classList that is not mocked properly
https://github.com/aframevr/aframe/actions/runs/3520429062/jobs/5901336232
I don't know either why it shows up only now. It may be good to create a PR just for this mocking fix if this PR is not merged right away.

I created #5176 with a slightly modified version of the fix @diarmidmackenzie

@dmarcos Do you want to take this fix? Or give more feedback on the discussion items above?

@diarmidmackenzie now that #5176 is merged, you should remove first those 4 lines and then merge changes from master to fix the conflict.

Of course - sorry, didn't immediately register the implications of your comment.

Those updates are done.

This reverts commit 84a0d63.

We can merge this once we remove the example. Thanks for sticking with it.

Ok - removed that file from examples\test so I think we're good now.

Thanks so much. Super appreciated

diarmidmackenzie added 2 commits March 22, 2022 14:12

Better handling of asset loading errors.

b21a413

Simple test for asset loading error.

a9c2834

dmarcos reviewed Mar 23, 2022

View reviewed changes

Ensure all assets loaded even when one is in error. Plus test cases.

53ff05a

vincentfretin reviewed Sep 11, 2022

View reviewed changes

Comment thread src/core/a-node.js Outdated

vincentfretin reviewed Sep 11, 2022

View reviewed changes

Comment thread src/core/a-node.js Outdated

fix typos

a3dd350

vincentfretin mentioned this pull request Sep 26, 2022

really run all tests and fix broken tests #5123

Merged

vincentfretin reviewed Sep 26, 2022

View reviewed changes

Comment thread tests/core/a-assets.test.js

diarmidmackenzie added 3 commits September 30, 2022 17:04

Merge remote-tracking branch 'upstream/master' into asset-loading-error

d258b19

Merge remote-tracking branch 'upstream/master' into asset-loading-error

d224351

Remove trailing spaces to pass linting checks.

7f3ba15

vincentfretin mentioned this pull request Oct 6, 2022

Asset loading hangs forever when errors hit loading an asset. #5032

Closed

diarmidmackenzie added 3 commits November 18, 2022 17:15

Merge remote-tracking branch 'upstream/master' into asset-loading-error

c4b9f12

Fix linting errors arising from merge

0f2e977

Fix up merge

2209a49

Fix test script that fails due to inadequate mocking of canvas.

84a0d63

vincentfretin mentioned this pull request Dec 1, 2022

Fix failing tests with firefox by mocking canvas.classList #5176

Merged

vincentfretin reviewed Dec 2, 2022

View reviewed changes

diarmidmackenzie added 2 commits December 4, 2022 15:59

Revert "Fix test script that fails due to inadequate mocking of canvas."

c8a3806

This reverts commit 84a0d63.

Merge remote-tracking branch 'upstream/master' into asset-loading-error

22605bf

Remove example - this is now tested in UT.

37aca83

dmarcos merged commit 5189765 into aframevr:master Dec 6, 2022

+                        // Failed to load a node, but things won't get any better by waiting around.
+                        // So get on with rendering the scene by signaling that this node has loaded.
+                        // An "error" event has already been fired, so we don't need to fire another one.
+                        warn('Rendering scene with errors on node: ', self);

+                <head>
+                  <meta charset="utf-8">
+                  <title>glTF Model</title>
+                  <meta name="description" content="glTF Model - A-Frame">

+                      classList: {
+                        add: function () {},
+                        remove: function () {}
+                      },

Possible fix for #5032: Don't hang forever on asset loading error by diarmidmackenzie · Pull Request #5033 · aframevr/aframe · GitHub

Uh oh!

Uh oh!

Possible fix for #5032: Don't hang forever on asset loading error - #5033

Possible fix for #5032: Don't hang forever on asset loading error#5033dmarcos merged 14 commits intoaframevr:masteraframevr/aframe:masterfrom diarmidmackenzie:asset-loading-errordiarmidmackenzie/aframe:asset-loading-errorCopy head branch name to clipboard

Conversation

diarmidmackenzie commented Mar 22, 2022

Uh oh!

dmarcos Mar 23, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

diarmidmackenzie commented May 3, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

diarmidmackenzie commented May 3, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

diarmidmackenzie commented Sep 15, 2022

Uh oh!

Uh oh!

vincentfretin commented Sep 28, 2022

Uh oh!

vincentfretin commented Sep 30, 2022

Uh oh!

diarmidmackenzie commented Sep 30, 2022

Uh oh!

dmarcos commented Nov 17, 2022

Uh oh!

diarmidmackenzie commented Nov 18, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

diarmidmackenzie commented Nov 18, 2022

Uh oh!

diarmidmackenzie commented Nov 18, 2022

Uh oh!

kylebakerio commented Nov 18, 2022

Uh oh!

vincentfretin commented Dec 1, 2022

Uh oh!

vincentfretin commented Dec 1, 2022

Uh oh!

diarmidmackenzie commented Dec 1, 2022

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dmarcos commented Dec 6, 2022

Uh oh!

diarmidmackenzie commented Dec 6, 2022

Uh oh!

dmarcos commented Dec 6, 2022

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

Possible fix for #5032: Don't hang forever on asset loading error#5033
dmarcos merged 14 commits into
aframevr:masterfrom
diarmidmackenzie:asset-loading-error

dmarcos Mar 23, 2022 •
edited
Loading

diarmidmackenzie commented May 3, 2022 •
edited
Loading

diarmidmackenzie commented May 3, 2022 •
edited
Loading

diarmidmackenzie commented Nov 18, 2022 •
edited
Loading