fix(browser): resolve FS commands relative to the project root (#7896)

Author: sheremet-va

docs/guide/browser/commands.md

@@ -11,7 +11,7 @@ Command is a function that invokes another function on the server and passes dow
 
 ### Files Handling
 
-You can use `readFile`, `writeFile` and `removeFile` API to handle files inside your browser tests. All paths are resolved relative to the test file even if they are called in a helper function located in another file.
+You can use the `readFile`, `writeFile`, and `removeFile` APIs to handle files in your browser tests. Since Vitest 3.2, all paths are resolved relative to the [project](/guide/workspace) root (which is `process.cwd()`, unless overriden manually). Previously, paths were resolved relative to the test file.
 
 By default, Vitest uses `utf-8` encoding but you can override it with options.
 

packages/browser/src/node/commands/fs.ts

@@ -18,8 +18,8 @@ function assertFileAccess(path: string, project: TestProject) {
 
 export const readFile: BrowserCommand<
   Parameters<BrowserCommands['readFile']>
-> = async ({ project, testPath = process.cwd() }, path, options = {}) => {
-  const filepath = resolve(dirname(testPath), path)
+> = async ({ project }, path, options = {}) => {
+  const filepath = resolve(project.config.root, path)
   assertFileAccess(filepath, project)
   // never return a Buffer
   if (typeof options === 'object' && !options.encoding) {
@@ -30,8 +30,8 @@ export const readFile: BrowserCommand<
 
 export const writeFile: BrowserCommand<
   Parameters<BrowserCommands['writeFile']>
-> = async ({ project, testPath = process.cwd() }, path, data, options) => {
-  const filepath = resolve(dirname(testPath), path)
+> = async ({ project }, path, data, options) => {
+  const filepath = resolve(project.config.root, path)
   assertFileAccess(filepath, project)
   const dir = dirname(filepath)
   if (!fs.existsSync(dir)) {
@@ -42,14 +42,14 @@ export const writeFile: BrowserCommand<
 
 export const removeFile: BrowserCommand<
   Parameters<BrowserCommands['removeFile']>
-> = async ({ project, testPath = process.cwd() }, path) => {
-  const filepath = resolve(dirname(testPath), path)
+> = async ({ project }, path) => {
+  const filepath = resolve(project.config.root, path)
   assertFileAccess(filepath, project)
   await fsp.rm(filepath)
 }
 
-export const _fileInfo: BrowserCommand<[path: string, encoding: BufferEncoding]> = async ({ project, testPath = process.cwd() }, path, encoding) => {
-  const filepath = resolve(dirname(testPath), path)
+export const _fileInfo: BrowserCommand<[path: string, encoding: BufferEncoding]> = async ({ project }, path, encoding) => {
+  const filepath = resolve(project.config.root, path)
   assertFileAccess(filepath, project)
   const content = await fsp.readFile(filepath, encoding || 'base64')
   return {