@ -1,9 +1,19 @@
import React from "react" ;
import React , { useEffect , useState } from "react" ;
import type { FunctionComponent } from "react" ;
import { render , screen } from "@testing-library/react" ;
import { SAMPLE_DATA_URI , setUpServer } from "./setUpServer" ;
import { render , screen , fireEvent } from "@testing-library/react" ;
import {
SAMPLE_BINARY_URI ,
SAMPLE_DATA_URI ,
SERVER_DOMAIN ,
setUpServer ,
} from "./setUpServer" ;
import { UnauthenticatedSolidLdoProvider } from "../src/UnauthenticatedSolidLdoProvider" ;
import { useResource } from "../src/useResource" ;
import { useRootContainerFor } from "../src/useRootContainer" ;
import { useLdo } from "../src/SolidLdoProvider" ;
import { PostShShapeType } from "./.ldo/post.shapeTypes" ;
import type { PostSh } from "./.ldo/post.typings" ;
import { useSubject } from "../src/useSubject" ;
// Use an increased timeout, since the CSS server takes too much setup time.
jest . setTimeout ( 40 _000 ) ;
@ -32,5 +42,317 @@ describe("Integration Tests", () => {
const resourceStatus = await screen . findByRole ( "status" ) ;
expect ( resourceStatus . innerHTML ) . toBe ( "dataReadSuccess" ) ;
} ) ;
it ( "returns undefined when no uri is provided, then rerenders when one is" , async ( ) = > {
const UseResourceUndefinedTest : FunctionComponent = ( ) = > {
const [ uri , setUri ] = useState < string | undefined > ( undefined ) ;
const resource = useResource ( uri , { suppressInitialRead : true } ) ;
if ( ! resource )
return (
< div >
< p > Undefined < / p >
< button onClick = { ( ) = > setUri ( SAMPLE_DATA_URI ) } > Next < / button >
< / div >
) ;
return < p role = "status" > { resource . status . type } < / p > ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< UseResourceUndefinedTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
await screen . findByText ( "Undefined" ) ;
fireEvent . click ( screen . getByText ( "Next" ) ) ;
const resourceStatus = await screen . findByRole ( "status" ) ;
expect ( resourceStatus . innerHTML ) . toBe ( "unfetched" ) ;
} ) ;
it ( "Reloads the data on mount" , async ( ) = > {
const ReloadTest : FunctionComponent = ( ) = > {
const resource = useResource ( SAMPLE_DATA_URI , { reloadOnMount : true } ) ;
if ( resource ? . isLoading ( ) ) return < p > Loading < / p > ;
return < p role = "status" > { resource . status . type } < / p > ;
} ;
const ReloadParent : FunctionComponent = ( ) = > {
const [ showComponent , setShowComponent ] = useState ( true ) ;
return (
< div >
< button onClick = { ( ) = > setShowComponent ( ! showComponent ) } >
Show Component
< / button >
{ showComponent ? < ReloadTest / > : < p > Hidden < / p > }
< / div >
) ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< ReloadParent / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
await screen . findByText ( "Loading" ) ;
const resourceStatus1 = await screen . findByRole ( "status" ) ;
expect ( resourceStatus1 . innerHTML ) . toBe ( "dataReadSuccess" ) ;
fireEvent . click ( screen . getByText ( "Show Component" ) ) ;
await screen . findByText ( "Hidden" ) ;
fireEvent . click ( screen . getByText ( "Show Component" ) ) ;
await screen . findByText ( "Loading" ) ;
const resourceStatus2 = await screen . findByRole ( "status" ) ;
expect ( resourceStatus2 . innerHTML ) . toBe ( "dataReadSuccess" ) ;
} ) ;
it ( "handles swapping to a new resource" , async ( ) = > {
const SwapResourceTest : FunctionComponent = ( ) = > {
const [ uri , setUri ] = useState ( SAMPLE_DATA_URI ) ;
const resource = useResource ( uri ) ;
if ( resource ? . isLoading ( ) ) return < p > Loading < / p > ;
return (
< div >
< p role = "status" > { resource . status . type } < / p >
< button onClick = { ( ) = > setUri ( SAMPLE_BINARY_URI ) } >
Update URI
< / button >
< / div >
) ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< SwapResourceTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
await screen . findByText ( "Loading" ) ;
const resourceStatus1 = await screen . findByRole ( "status" ) ;
expect ( resourceStatus1 . innerHTML ) . toBe ( "dataReadSuccess" ) ;
fireEvent . click ( screen . getByText ( "Update URI" ) ) ;
await screen . findByText ( "Loading" ) ;
const resourceStatus2 = await screen . findByRole ( "status" ) ;
expect ( resourceStatus2 . innerHTML ) . toBe ( "binaryReadSuccess" ) ;
} ) ;
} ) ;
describe ( "useRootContainer" , ( ) = > {
it ( "gets the root container for a sub-resource" , async ( ) = > {
const RootContainerTest : FunctionComponent = ( ) = > {
const rootContainer = useRootContainerFor ( SAMPLE_DATA_URI , {
suppressInitialRead : true ,
} ) ;
return rootContainer ? (
< p role = "root" > { rootContainer ? . uri } < / p >
) : undefined ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< RootContainerTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const container = await screen . findByRole ( "root" ) ;
expect ( container . innerHTML ) . toBe ( SERVER_DOMAIN ) ;
} ) ;
it ( "returns undefined when a URI is not provided" , async ( ) = > {
const RootContainerTest : FunctionComponent = ( ) = > {
const rootContainer = useRootContainerFor ( undefined , {
suppressInitialRead : true ,
} ) ;
return rootContainer ? (
< p role = "root" > { rootContainer ? . uri } < / p >
) : (
< p role = "undefined" > Undefined < / p >
) ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< RootContainerTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const container = await screen . findByRole ( "undefined" ) ;
expect ( container . innerHTML ) . toBe ( "Undefined" ) ;
} ) ;
} ) ;
describe ( "useLdoMethod" , ( ) = > {
it ( "uses get subject to get a linked data object" , async ( ) = > {
const GetSubjectTest : FunctionComponent = ( ) = > {
const [ subject , setSubject ] = useState < PostSh | undefined > ( ) ;
const { getSubject } = useLdo ( ) ;
useEffect ( ( ) = > {
const someSubject = getSubject (
PostShShapeType ,
"https://example.com/subject" ,
) ;
setSubject ( someSubject ) ;
} , [ ] ) ;
return subject ? < p role = "subject" > { subject [ "@id" ] } < / p > : undefined ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< GetSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const container = await screen . findByRole ( "subject" ) ;
expect ( container . innerHTML ) . toBe ( "https://example.com/subject" ) ;
} ) ;
it ( "uses createData to create a new data object" , async ( ) = > {
const GetSubjectTest : FunctionComponent = ( ) = > {
const [ subject , setSubject ] = useState < PostSh | undefined > ( ) ;
const { createData , getResource } = useLdo ( ) ;
useEffect ( ( ) = > {
const someSubject = createData (
PostShShapeType ,
"https://example.com/subject" ,
getResource ( "https://example.com/" ) ,
) ;
someSubject . articleBody = "Cool Article" ;
setSubject ( someSubject ) ;
} , [ ] ) ;
return subject ? (
< p role = "subject" > { subject . articleBody } < / p >
) : undefined ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< GetSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const container = await screen . findByRole ( "subject" ) ;
expect ( container . innerHTML ) . toBe ( "Cool Article" ) ;
} ) ;
} ) ;
describe ( "useSubject" , ( ) = > {
it ( "renders the article body from the useSubject value" , async ( ) = > {
const UseSubjectTest : FunctionComponent = ( ) = > {
useResource ( SAMPLE_DATA_URI ) ;
const post = useSubject ( PostShShapeType , ` ${ SAMPLE_DATA_URI } #Post1 ` ) ;
return < p role = "article" > { post . articleBody } < / p > ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< UseSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
await screen . findByText ( "test" ) ;
} ) ;
it ( "renders the array value from the useSubject value" , async ( ) = > {
const UseSubjectTest : FunctionComponent = ( ) = > {
const resource = useResource ( SAMPLE_DATA_URI ) ;
const post = useSubject ( PostShShapeType , ` ${ SAMPLE_DATA_URI } #Post1 ` ) ;
if ( resource . isLoading ( ) || ! post ) return < p > loading < / p > ;
return (
< div >
< p role = "single" > { post . publisher [ 0 ] [ "@id" ] } < / p >
< ul role = "list" >
{ post . publisher . map ( ( publisher ) = > {
return < li key = { publisher [ "@id" ] } > { publisher [ "@id" ] } < / li > ;
} ) }
< / ul >
< / div >
) ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< UseSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const single = await screen . findByRole ( "single" ) ;
expect ( single . innerHTML ) . toBe ( "https://example.com/Publisher1" ) ;
const list = await screen . findByRole ( "list" ) ;
expect ( list . children [ 0 ] . innerHTML ) . toBe ( "https://example.com/Publisher1" ) ;
expect ( list . children [ 1 ] . innerHTML ) . toBe ( "https://example.com/Publisher2" ) ;
} ) ;
it ( "returns undefined in the subject URI is undefined" , async ( ) = > {
const UseSubjectTest : FunctionComponent = ( ) = > {
useResource ( SAMPLE_DATA_URI , { suppressInitialRead : true } ) ;
const post = useSubject ( PostShShapeType , undefined ) ;
return (
< p role = "article" >
{ post === undefined ? "Undefined" : "Not Undefined" }
< / p >
) ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< UseSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const article = await screen . findByRole ( "article" ) ;
expect ( article . innerHTML ) . toBe ( "Undefined" ) ;
} ) ;
it ( "returns nothing if a symbol key is provided" , async ( ) = > {
const UseSubjectTest : FunctionComponent = ( ) = > {
const resource = useResource ( SAMPLE_DATA_URI ) ;
const post = useSubject ( PostShShapeType , ` ${ SAMPLE_DATA_URI } #Post1 ` ) ;
if ( resource . isLoading ( ) || ! post ) return < p > loading < / p > ;
return < p role = "value" > { typeof post [ Symbol . hasInstance ] } < / p > ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< UseSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const article = await screen . findByRole ( "value" ) ;
expect ( article . innerHTML ) . toBe ( "undefined" ) ;
} ) ;
it ( "returns an id if an id key is provided" , async ( ) = > {
const UseSubjectTest : FunctionComponent = ( ) = > {
const resource = useResource ( SAMPLE_DATA_URI ) ;
const post = useSubject ( PostShShapeType , ` ${ SAMPLE_DATA_URI } #Post1 ` ) ;
if ( resource . isLoading ( ) || ! post ) return < p > loading < / p > ;
return < p role = "value" > { post [ "@id" ] } < / p > ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< UseSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const article = await screen . findByRole ( "value" ) ;
expect ( article . innerHTML ) . toBe ( ` ${ SAMPLE_DATA_URI } #Post1 ` ) ;
} ) ;
it ( "does not set a value if a value is attempted to be set" , async ( ) = > {
const warn = jest . spyOn ( console , "warn" ) . mockImplementation ( ( ) = > { } ) ;
const UseSubjectTest : FunctionComponent = ( ) = > {
const resource = useResource ( SAMPLE_DATA_URI ) ;
const post = useSubject ( PostShShapeType , ` ${ SAMPLE_DATA_URI } #Post1 ` ) ;
if ( resource . isLoading ( ) || ! post ) return < p > loading < / p > ;
return (
< div >
< p role = "value" > { post . articleBody } < / p >
< button onClick = { ( ) = > ( post . articleBody = "bad" ) } >
Attempt Change
< / button >
< / div >
) ;
} ;
render (
< UnauthenticatedSolidLdoProvider >
< UseSubjectTest / >
< / UnauthenticatedSolidLdoProvider > ,
) ;
const article = await screen . findByRole ( "value" ) ;
expect ( article . innerHTML ) . toBe ( ` test ` ) ;
fireEvent . click ( screen . getByText ( "Attempt Change" ) ) ;
expect ( article . innerHTML ) . not . toBe ( "bad" ) ;
expect ( warn ) . toHaveBeenCalledWith (
"You've attempted to set a value on a Linked Data Object from the useSubject, useMatchingSubject, or useMatchingObject hooks. These linked data objects should only be used to render data, not modify it. To modify data, use the `changeData` function." ,
) ;
warn . mockReset ( ) ;
} ) ;
} ) ;
} ) ;
jaxoncreed
2 years ago
committed by