webdriver-0.3.1: a Haskell client for the Selenium WebDriver protocol

Safe HaskellNone




A type for profile preferences. These preference values are used by both Firefox and Opera profiles.


Profiles and profile preferences

data Profile b Source

This structure allows you to construct and manipulate profiles in pure code, deferring execution of IO operations until the profile is "prepared". This type is shared by both Firefox and Opera profile code; when a distinction must be made, the phantom type parameter is used to differentiate.




profileFiles :: [(FilePath, FilePath)]

A set of filepaths pointing to files to place in the extension directory. The first tuple element is the source path. The second tuple element is the destination path relative to the extension of the file.

profilePrefs :: HashMap Text ProfilePref

A map of Firefox preferences. These are the settings found in the profile's prefs.js, and entries found in about:config


Eq (Profile b) 
Show (Profile b) 

newtype PreparedProfile b Source

Represents a profile that has been prepared for network transmission. The profile cannot be modified in this form.

data ProfilePref Source

A profile preference value. This is the subset of JSON values that excludes arrays, objects, and null.

class ToPref a whereSource

A typeclass to convert types to profile preference values


toPref :: a -> ProfilePrefSource

getPref :: Text -> Profile b -> Maybe ProfilePrefSource

Retrieve a preference from a profile by key name.

addPref :: ToPref a => Text -> a -> Profile b -> Profile bSource

Add a new preference entry to a profile, overwriting any existing entry with the same key.

deletePref :: Text -> Profile b -> Profile bSource

Delete an existing preference entry from a profile. This operation is silent if the preference wasn't found.

addExtension :: FilePath -> Profile b -> Profile bSource

Add a new extension to the profile. The file path should refer to an .xpi file or an extension directory on the filesystem. If possible, you should avoiding adding the same extension twice to a given profile.

deleteExtension :: String -> Profile b -> Profile bSource

Delete an existing extension from the profile. The string parameter should refer to an .xpi file or directory located within the extensions directory of the profile. This operation has no effect if the extension was never added to the profile.

Preparing profiles from disk

prepareLoadedProfile_ :: MonadBase IO m => FilePath -> m (PreparedProfile a)Source

Efficiently load an existing profile from disk and prepare it for network transmission.

Preparing zipped profiles

prepareZippedProfile :: MonadBase IO m => FilePath -> m (PreparedProfile a)Source

Prepare a zip file of a profile on disk for network transmission. This function is very efficient at loading large profiles from disk.

prepareZipArchive :: Archive -> PreparedProfile aSource

Prepare a zip archive of a profile for network transmission.

prepareRawZip :: ByteString -> PreparedProfile aSource

Prepare a ByteString of raw zip data for network transmission

Profile errors

newtype ProfileParseError Source

An error occured while attempting to parse a profile's preference file.