keepBrowserProfile

keepBrowserProfile은 개발 시 브라우저 사용자 데이터(profile)를 유지할지 여부를 제어합니다.

개요

타입: boolean
기본값: false
필수 여부: 아니오

사용법

// addfox.config.ts
import { defineConfig } from "addfox";

export default defineConfig({
  keepBrowserProfile: true,  // 실행 사이에 브라우저 profile 유지
});

역할

활성화하면:

개발 시 브라우저 사용자 데이터가 .addfox/cache/browser-profile/<name>-user-data 디렉토리에 저장됩니다
다음에 addfox dev를 시작할 때 이 데이터를 재사용합니다
로그인 상태, 확장 설정 등이 유지됩니다

브라우저별로 최상위 구성을 재정의할 수도 있습니다:

export default defineConfig({
  browser: {
    chrome: { keepBrowserProfile: true },
  },
});

우선순위

다음 순서로 해석됩니다(높은 순):

CLI --keep-browser-profile / --no-keep-browser-profile
browser.<name>.keepBrowserProfile (브라우저별 재정의)
최상위 keepBrowserProfile
Deprecated cache (CLI -c/--cache, --no-cache 또는 구성 cache)
기본값 false

CLI 파라미터

CLI 파라미터는 설정보다 우선순위가 높습니다:

pnpm

npm

yarn

bun

# profile 유지 강제 활성화 (설정이 false여도)
pnpm dev -- --keep-browser-profile

# 새 profile 강제 사용 (설정이 true여도)
pnpm dev -- --no-keep-browser-profile

--keep-browser-profile과 --no-keep-browser-profile이 동시에 있으면 마지막 파라미터가 우선합니다.

Warning

구성 필드 cache와 CLI 파라미터 -c/--cache, --no-cache는 deprecated 별칭이며, 여전히 동작하지만 터미널에 deprecated 경고를 출력합니다. keepBrowserProfile과 --keep-browser-profile / --no-keep-browser-profile로 마이그레이션하세요.

주의사항

개발 모드(addfox dev)에만 영향을 줍니다
Firefox에는 영향을 주지 않습니다. Firefox profile은 web-ext가 관리합니다
이상한 문제가 발생하면 .addfox/cache/ 디렉토리를 삭제해 보세요

buildCache

buildCache는 Rspack 영구 빌드 캐시를 제어하여 반복 빌드를 가속합니다.

개요

타입: boolean | { cacheDirectory?: string }
기본값: true
캐시 파일은 <outputRoot>/cache/build/에 저장됩니다

사용법

export default defineConfig({
  // 빌드 캐시 비활성화
  buildCache: false,
});

export default defineConfig({
  // 사용자 정의 캐시 디렉토리
  buildCache: { cacheDirectory: "./node_modules/.cache/addfox-build" },
});

더 깊은 rsbuild/rspack 사용자 정의가 필요하면 기존 rsbuild 구성 필드(객체 깊은 병합 또는 함수 형태)를 사용하세요.

#keepBrowserProfile

#개요

#사용법

#역할

#우선순위

#CLI 파라미터

#주의사항

#buildCache

#개요