11// @vitest -environment happy-dom
22
3- import { describe , expect , it } from "vitest" ;
3+ import { act , createElement } from "react" ;
4+ import { createRoot , type Root } from "react-dom/client" ;
5+ import { afterEach , describe , expect , it , vi } from "vitest" ;
46import {
57 hasUnloadedAssets ,
8+ Player ,
69 readPreviewErrorMessage ,
710 shouldShowCompositionLoadingOverlay ,
811} from "./Player" ;
912
13+ vi . mock ( "@hyperframes/player" , ( ) => ( { } ) ) ;
14+
15+ Object . assign ( globalThis , { IS_REACT_ACT_ENVIRONMENT : true } ) ;
16+
17+ let root : Root | null = null ;
18+ let lifecycleLog : string [ ] = [ ] ;
19+
20+ class TestHyperframesPlayer extends HTMLElement {
21+ readonly iframeElement = document . createElement ( "iframe" ) ;
22+
23+ constructor ( ) {
24+ super ( ) ;
25+
26+ const addIframeListener = this . iframeElement . addEventListener . bind ( this . iframeElement ) ;
27+ this . iframeElement . addEventListener = ( ( type , listener , options ) => {
28+ lifecycleLog . push ( `iframe:${ type } ` ) ;
29+ addIframeListener ( type , listener , options ) ;
30+ } ) as typeof this . iframeElement . addEventListener ;
31+
32+ const addPlayerListener = this . addEventListener . bind ( this ) ;
33+ this . addEventListener = ( ( type , listener , options ) => {
34+ lifecycleLog . push ( `player:${ type } ` ) ;
35+ addPlayerListener ( type , listener , options ) ;
36+ } ) as typeof this . addEventListener ;
37+
38+ const setPlayerAttribute = this . setAttribute . bind ( this ) ;
39+ this . setAttribute = ( name , value ) => {
40+ if ( name === "src" ) lifecycleLog . push ( "src" ) ;
41+ setPlayerAttribute ( name , value ) ;
42+ } ;
43+ }
44+ }
45+
46+ if ( ! customElements . get ( "hyperframes-player" ) ) {
47+ customElements . define ( "hyperframes-player" , TestHyperframesPlayer ) ;
48+ }
49+
50+ afterEach ( ( ) => {
51+ if ( root ) act ( ( ) => root ?. unmount ( ) ) ;
52+ root = null ;
53+ lifecycleLog = [ ] ;
54+ document . body . innerHTML = "" ;
55+ } ) ;
56+
57+ async function mountPlayer ( ) {
58+ const host = document . createElement ( "div" ) ;
59+ document . body . append ( host ) ;
60+ root = createRoot ( host ) ;
61+ await act ( async ( ) => {
62+ root ?. render (
63+ createElement ( Player , {
64+ directUrl : "/api/projects/demo/preview" ,
65+ onLoad : vi . fn ( ) ,
66+ suppressLoadingOverlay : true ,
67+ } ) ,
68+ ) ;
69+ await Promise . resolve ( ) ;
70+ } ) ;
71+
72+ const player = host . querySelector < TestHyperframesPlayer > ( "hyperframes-player" ) ;
73+ if ( ! player ) throw new Error ( "player did not mount" ) ;
74+ return { host, player } ;
75+ }
76+
1077function createAudioIframe ( ) {
1178 const iframe = document . createElement ( "iframe" ) ;
1279 document . body . appendChild ( iframe ) ;
@@ -32,6 +99,47 @@ describe("preview errors", () => {
3299 "The composition preview did not become ready." ,
33100 ) ;
34101 } ) ;
102+
103+ it ( "attaches lifecycle listeners before navigating the player" , async ( ) => {
104+ await mountPlayer ( ) ;
105+ const srcIndex = lifecycleLog . indexOf ( "src" ) ;
106+
107+ expect ( srcIndex ) . toBeGreaterThan ( - 1 ) ;
108+ for ( const listener of [
109+ "iframe:load" ,
110+ "player:click" ,
111+ "player:shadertransitionstate" ,
112+ "player:ready" ,
113+ "player:error" ,
114+ ] ) {
115+ expect ( lifecycleLog . indexOf ( listener ) ) . toBeGreaterThan ( - 1 ) ;
116+ expect ( lifecycleLog . indexOf ( listener ) ) . toBeLessThan ( srcIndex ) ;
117+ }
118+ } ) ;
119+
120+ it ( "retries a failed preview with a fresh player URL" , async ( ) => {
121+ const { host, player } = await mountPlayer ( ) ;
122+
123+ act ( ( ) => {
124+ player . dispatchEvent (
125+ new CustomEvent ( "error" , {
126+ detail : { message : "Composition timeline not found after 8s" } ,
127+ } ) ,
128+ ) ;
129+ } ) ;
130+
131+ expect ( host . querySelector ( '[data-testid="composition-preview-error"]' ) ) . not . toBeNull ( ) ;
132+ const retry = Array . from ( host . querySelectorAll ( "button" ) ) . find (
133+ ( button ) => button . textContent === "Retry preview" ,
134+ ) ;
135+ if ( ! retry ) throw new Error ( "retry action did not render" ) ;
136+
137+ act ( ( ) => retry . click ( ) ) ;
138+
139+ const retryUrl = new URL ( player . getAttribute ( "src" ) ?? "" , window . location . origin ) ;
140+ expect ( retryUrl . searchParams . get ( "_hfStudioRetry" ) ) . toBe ( "1" ) ;
141+ expect ( host . querySelector ( '[data-testid="composition-preview-error"]' ) ) . toBeNull ( ) ;
142+ } ) ;
35143} ) ;
36144
37145describe ( "composition loading overlay" , ( ) => {
0 commit comments