@salesforce/b2c-tooling-sdk / clients / WebDavClient
Class: WebDavClient
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:93
Constructors
Constructor
new WebDavClient(
hostname,auth,options?):WebDavClient
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:106
Creates a new WebDAV client.
Parameters
hostname
string
WebDAV hostname (may differ from API hostname)
auth
Authentication strategy to use for requests
options?
Optional configuration including middleware registry and TLS dispatcher
Returns
WebDavClient
Methods
buildUrl()
buildUrl(
path):string
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:123
Builds the full URL for a WebDAV path.
Parameters
path
string
Path relative to /webdav/Sites/
Returns
string
Full URL
copy()
copy(
source,destination,overwrite):Promise<void>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:457
Copies a file or directory.
Parameters
source
string
Source path relative to /webdav/Sites/
destination
string
Destination path relative to /webdav/Sites/
overwrite
boolean = true
Whether to overwrite if destination exists (default: true)
Returns
Promise<void>
Example
await client.copy('Cartridges/v1/cartridge', 'Cartridges/v2/cartridge');delete()
delete(
path,options):Promise<void>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:394
Deletes a file or directory.
Parameters
path
string
Path to delete
options
WebDavRequestOptions = {}
Returns
Promise<void>
Throws
Error if the path doesn't exist (404) or deletion fails
Example
await client.delete('Cartridges/v1/old-cartridge');exists()
exists(
path,options):Promise<boolean>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:529
Checks if a path exists.
Parameters
path
string
Path to check
options
WebDavRequestOptions = {}
Returns
Promise<boolean>
true if exists, false otherwise
get()
get(
path,options):Promise<ArrayBuffer>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:375
Downloads a file.
Parameters
path
string
Path to download
options
WebDavRequestOptions = {}
Returns
Promise<ArrayBuffer>
File content as ArrayBuffer
Example
const content = await client.get('Cartridges/v1/app.zip');getTextRange()
getTextRange(
path,options):Promise<WebDavTextRange>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:507
Reads a byte range of a text file, decoding only complete UTF-8 characters. Continue with the returned nextOffset. path should come from normalizeWebDavPath.
Parameters
path
string
options
Returns
Promise<WebDavTextRange>
Example
const recent = await instance.webdav.getTextRange('Logs/error-blade1.log', {tail: true, maxBytes: 8000});mkcol()
mkcol(
path,options):Promise<void>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:319
Creates a directory (collection).
Parameters
path
string
Path to create
options
WebDavRequestOptions = {}
Returns
Promise<void>
Throws
Error if creation fails (except 405 which means already exists)
Example
await client.mkcol('Cartridges/v1');move()
move(
source,destination,overwrite):Promise<void>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:482
Moves (renames) a file or directory.
Parameters
source
string
Source path relative to /webdav/Sites/
destination
string
Destination path relative to /webdav/Sites/
overwrite
boolean = true
Whether to overwrite if destination exists (default: true)
Returns
Promise<void>
Example
await client.move('Cartridges/v1/old-name', 'Cartridges/v1/new-name');propfind()
propfind(
path,depth,options):Promise<PropfindEntry[]>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:415
Lists directory contents.
Parameters
path
string
Directory path
depth
PROPFIND depth (0, 1, or 'infinity')
"0" | "1" | "infinity"
options
WebDavRequestOptions = {}
Returns
Promise<PropfindEntry[]>
Array of entries in the directory
Example
const entries = await client.propfind('Cartridges');
for (const entry of entries) {
console.log(entry.displayName, entry.isCollection);
}put()
put(
path,content,contentType?,options?):Promise<void>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:345
Uploads a file.
Parameters
path
string
Destination path
content
File content as Buffer, Blob, or string
string | Buffer<ArrayBufferLike> | Blob
contentType?
string
Optional content type header
options?
WebDavRequestOptions = {}
Returns
Promise<void>
Example
await client.put('Cartridges/v1/app.zip', zipBuffer, 'application/zip');request()
request(
path,init?):Promise<Response>
Defined in: packages/b2c-tooling-sdk/src/clients/webdav.ts:154
Makes a raw WebDAV request.
Parameters
path
string
Path relative to /webdav/Sites/
init?
RequestInit
Fetch init options
Returns
Promise<Response>
Response from the server