feat(api): add mock for convertFileSrc, closes #7935

.changes/api-convert-file-src-mock.md

@@ -0,0 +1,5 @@
+---
+'@tauri-apps/api': 'minor:feat'
+---
+
+Add `mockConvertFileSrc` in `mocks` module, to mock `convertFileSrc` function.

tooling/api/src/mocks.ts

@@ -2,6 +2,8 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-License-Identifier: MIT
 
+import { convertFileSrc } from './tauri'
+
 interface IPCMessage {
   cmd: string
   callback: number
@@ -142,6 +144,37 @@ export function mockWindows(
   }
 }
 
+/**
+ * Mock {@linkcode convertFileSrc} function
+ *
+ *
+ * @example
+ * ```js
+ * import { mockConvertFileSrc } from "@tauri-apps/api/mocks";
+ * import { convertFileSrc } from "@tauri-apps/api/tauri";
+ *
+ * mockConvertFileSrc("windows")
+ *
+ * const url = convertFileSrc("C:\\Users\\user\\file.txt")
+ * ```
+ *
+ * @param osName The operating system to mock, can be one of linux, macos, or windows
+ * @param windowsProtocolScheme The scheme to use on Windows, can be either `http` or `https` and defaults to `https`
+ *
+ * @since 1.6.0
+ */
+export function mockConvertFileSrc(
+  osName: string,
+  windowsProtocolScheme = 'https'
+) {
+  window.__TAURI__.convertFileSrc = function (filePath, protocol = 'asset') {
+    const path = encodeURIComponent(filePath)
+    return osName === 'windows'
+      ? `${windowsProtocolScheme}://${protocol}.localhost/${path}`
+      : `${protocol}://localhost/${path}`
+  }
+}
+
 /**
  * Clears mocked functions/data injected by the other functions in this module.
  * When using a test runner that doesn't provide a fresh window object for each test, calling this function will reset tauri specific properties.
@@ -169,6 +202,8 @@ export function mockWindows(
  * @since 1.0.0
  */
 export function clearMocks(): void {
+  // @ts-expect-error "The operand of a 'delete' operator must be optional' does not matter in this case
+  delete window.__TAURI__.convertFileSrc
   // @ts-expect-error "The operand of a 'delete' operator must be optional' does not matter in this case
   delete window.__TAURI_IPC__
   // @ts-expect-error "The operand of a 'delete' operator must be optional' does not matter in this case