SecureErase (secure file deletion)

function SecureErase(what: string, passes?: number): boolean;

Tries to delete the file specified by what from the local file system using a secure erasure algorithm. The file is overwritten with cryptographically secure pseudo-random data before deletion, making recovery extremely difficult. The optional passes parameter specifies how many times the file should be overwritten; if omitted, the file is overwritten once.

Parameter	Type	Requirement	Explanation
what	string	required	Path to a valid, existing file in the local file system
passes	number	optional	Number of overwrite passes before deletion (default: 1)

Return value	Explanation
true	The file was securely deleted
false	The operation failed; the file was not deleted (but it may still have been overwritten)

Example (Windows, default passes)

if (SecureErase('C:\\Data\\SomeFile.docx')) {
  Log('File securely deleted.');
} else {
  Log('Secure erase failed.');
}

Example (Linux, with 3 passes)

if (SecureErase('/home/someuser/data/SomeFile.pdf', 3)) {
  Log('File securely deleted after 3 passes.');
} else {
  Log('Secure erase failed.');
}