gildas-lormeau/SingleFile · error · Error

error.message + " (WebDAV)"

Error message

error.message + " (WebDAV)"

What it means

saveWithWebDAV wraps any error from the WebDAV client upload (new WebDAV(url, username, password).upload(...)) and rethrows with an " (WebDAV)" suffix, preserving the original error as cause. It identifies the WebDAV save destination as the failure point.

Source

Thrown at src/core/bg/downloads.js:508

			const client = new S3(region, bucket, accessKey, secretKey, domain);
			business.setCancelCallback(taskId, () => client.abort());
			return await client.upload(filename, blob, { filenameConflictAction, prompt });
		}
	} catch (error) {
		throw new Error(error.message + " (S3)", { cause: error });
	}
}

async function saveWithWebDAV(taskId, filename, content, url, username, password, { filenameConflictAction, prompt }) {
	try {
		const taskInfo = business.getTaskInfo(taskId);
		if (!taskInfo || !taskInfo.cancelled) {
			const client = new WebDAV(url, username, password);
			business.setCancelCallback(taskId, () => client.abort());
			return await client.upload(filename, content, { filenameConflictAction, prompt });
		}
	} catch (error) {
		throw new Error(error.message + " (WebDAV)", { cause: error });
	}
}

async function saveWithMCP(taskId, filename, content, serverUrl, authToken, { filenameConflictAction, prompt }) {
	try {
		const taskInfo = business.getTaskInfo(taskId);
		if (!taskInfo || !taskInfo.cancelled) {
			const client = new MCP(serverUrl, authToken);
			business.setCancelCallback(taskId, () => client.abort());
			return await client.upload(filename, content, { filenameConflictAction, prompt });
		}
	} catch (error) {
		throw new Error(error.message + " (MCP)", { cause: error });
	}
}

async function saveToGDrive(taskId, filename, blob, authOptions, uploadOptions) {
	try {

View on GitHub (pinned to 517fb7c5cf)

Solutions

  1. Check error.cause for the HTTP status and verify the WebDAV URL is the full collection endpoint
  2. Re-enter username/password (or app password for Nextcloud/ownCloud)
  3. Confirm the server is reachable in a browser or via curl and its TLS certificate is valid
  4. Ensure the target directory exists on the WebDAV server

Example fix

// before
new WebDAV('myserver.com/dav', user, pass); // missing scheme
// after
new WebDAV('https://myserver.com/remote.php/dav/files/me', user, pass);
Defensive patterns

Strategy: validation

Validate before calling

const u = new URL(url);
if (!/^https?:$/.test(u.protocol)) throw new Error('WebDAV URL must be http(s)');
if (!username || !password) throw new Error('Missing WebDAV credentials');

Type guard

function hasWebDAVConfig(o) {
  try { const p = new URL(o.url).protocol; return (p === 'https:' || p === 'http:') &&
    !!o.username && !!o.password; } catch { return false; }
}

Try / catch

try {
  await saveWithWebDAV(taskId, filename, content, webdavOpts);
} catch (error) {
  if (error.message.endsWith('(WebDAV)')) {
    if (String(error.cause).includes('401')) { /* prompt for credentials */ }
  } else { throw error; }
}

Prevention

When it happens

Trigger: Any rejection inside WebDAV.upload(filename, content, {filenameConflictAction, prompt}) from downloadContent/downloadCompressedContent: connection failure, 401 auth error, 404 path not found, or abort.

Common situations: Wrong WebDAV server URL (missing https:// or wrong path); incorrect username/password; server certificate invalid (self-signed); Nextcloud/ownCloud app password revoked; firewall blocking the server.

Related errors

AI-assisted analysis of gildas-lormeau/SingleFile@517fb7c5cf (2026-09-01). Data as JSON: /api/errors/236ca2ca58652360. Report an issue: GitHub.