Skip to content

@ui5/fs/ResourceFacade

@ui5/fs/ResourceFacade

A Resource with a different path than it's original

Constructor

new @ui5/fs/ResourceFacade(parameters)

Source: fs/lib/ResourceFacade.js, line 10

Parameters:
NameTypeDescription
parametersobjectParameters
Properties:
NameTypeDescription
pathstringVirtual path of the facade resource
resource@ui5/fs/ResourceResource to conceal

Methods

(async) clone() → {Promise<@ui5/fs/Resource>}

Description: Returns a clone of the resource. The clones content is independent from that of the original resource. A ResourceFacade becomes a Resource

Source: fs/lib/ResourceFacade.js, line 75

Returns:

Promise resolving with the clone

Type: Promise<@ui5/fs/Resource>

(async) getBuffer() → {Promise<Buffer>}

Description: Gets a buffer with the resource content.

Source: fs/lib/ResourceFacade.js, line 93

Returns:

Promise resolving with a buffer of the resource content.

Type: Promise<Buffer>

getName() → {string}

Description: Gets the resource name

Source: fs/lib/ResourceFacade.js, line 54

Returns:

Name of the resource

Type: string

getPath() → {string}

Description: Gets the resources path

Source: fs/lib/ResourceFacade.js, line 44

Returns:

(Virtual) path of the resource

Type: string

Description: Retrieve the project assigned to the resource
Note for UI5 CLI extensions (i.e. custom tasks, custom middleware): In order to ensure compatibility across UI5 CLI versions, consider using the getProject(resource) method provided by TaskUtil and MiddlewareUtil, which will return a Specification Version-compatible Project interface.

Source: fs/lib/ResourceFacade.js, line 208

Returns:

Project this resource is associated with

Type: @ui5/project/specifications/Project

getStatInfo() → {fs.Stats|object}

Description: Gets the resources stat info. Note that a resources stat information is not updated when the resource is being modified. Also, depending on the used adapter, some fields might be missing which would be present for a fs.Stats instance.

Source: fs/lib/ResourceFacade.js, line 163

Returns:

Instance of fs.Stats or similar object

Type: fs.Stats | object

getStream() → {stream.Readable}

Description: Gets a readable stream for the resource content.

Repetitive calls of this function are only possible if new content has been set in the meantime (through setStream, setBuffer or setString). This is to prevent consumers from accessing drained streams.

Source: fs/lib/ResourceFacade.js, line 138

Returns:

Readable stream for the resource content.

Type: stream.Readable

getString() → {Promise<string>}

Description: Gets a string with the resource content.

Source: fs/lib/ResourceFacade.js, line 113

Returns:

Promise resolving with the resource content.

Type: Promise<string>

hasProject() → {boolean}

Description: Check whether a project has been assigned to the resource

Source: fs/lib/ResourceFacade.js, line 228

Returns:

True if the resource is associated with a project

Type: boolean

isModified() → {boolean}

Description: Check whether the content of this resource has been changed during its life cycle

Source: fs/lib/ResourceFacade.js, line 237

Returns:

True if the resource's content has been changed

Type: boolean

setBuffer(buffer)

Description: Sets a Buffer as content.

Source: fs/lib/ResourceFacade.js, line 103

Parameters:
NameTypeDescription
bufferBufferBuffer instance

setPath(path)

Description: Sets the resources path

Source: fs/lib/ResourceFacade.js, line 64

Parameters:
NameTypeDescription
pathstring(Virtual) path of the resource

setProject(project)

Description: Assign a project to the resource

Source: fs/lib/ResourceFacade.js, line 218

Parameters:
NameTypeDescription
project@ui5/project/specifications/ProjectProject this resource is associated with

setStream(stream)

Description: Sets a readable stream as content.

Source: fs/lib/ResourceFacade.js, line 149

Parameters:
NameTypeDescription
streamstream.Readable | @ui5/fs/Resource~createStreamReadable stream of the resource content or
callback for dynamic creation of a readable stream

setString(string)

Description: Sets a String as content

Source: fs/lib/ResourceFacade.js, line 123

Parameters:
NameTypeDescription
stringstringResource content