Skip to content

@capgo/capacitor-flash

Control the device torch with availability checks, intensity, and toggle helpers.

@capgo/capacitor-flash exposes flashlight control for QR scanners, safety tools, and camera companion flows. Check isAvailable(), turn the torch on with optional intensity, and read isSwitchedOn() before updating UI state.

iOS uses AVFoundation. Android uses Camera2 with intensity on supported API levels. Web uses the camera torch API where mobile browsers allow it.

PlatformSupportNotes
iOSYesAVFoundation torch
AndroidYesCamera2, intensity on Android 13+ where supported
WebPartialMobile Chrome torch when permitted
  • isAvailable - Checks if flashlight is available on the device.
  • switchOn - Turns the flashlight on.
  • switchOff - Turns the flashlight off.
  • isSwitchedOn - Checks if the flashlight is currently turned on or off.
MethodDescription
isAvailableChecks if flashlight is available on the device.
switchOnTurns the flashlight on.
switchOffTurns the flashlight off.
isSwitchedOnChecks if the flashlight is currently turned on or off.
toggleToggle the flashlight on or off.
getPluginVersionGet the native Capacitor plugin version.

This reference is synced from src/definitions.ts in capacitor-flash.

If you are using @capgo/capacitor-flash to plan dashboard and API operations, connect it with Using @capgo/capacitor-flash for the native capability in Using @capgo/capacitor-flash, API Overview for the implementation detail in API Overview, Introduction for the implementation detail in Introduction, API Keys for the implementation detail in API Keys, and Devices for the implementation detail in Devices.