Your Search Results


    Components can implement this interface to provide information to allow a database to be periodically vacuumed by the Storage service.
    Gecko 2.0
    Inherits from: nsISupports Last changed in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)

    To create an instance of this interface, use the Category Manger, with the category "vacuum-participant".

    Add more details here.

    Method overview

    boolean onBeginVacuum();
    void onEndVacuum(in boolean aSucceeded);


    Attribute Type Description
    databaseConnection mozIStorageConnection A connection to the database file to be vacuumed.
    expectedDatabasePageSize long

    The expected page size, in bytes, for the database. The vacuum manager will try to correct the page size when the browser is idle, using this value as a target. Valid page sizes are in the range 512 to 65,536. The recommended value is mozIStorageConnection::DEFAULT_PAGE_SIZE.

    Note: If the database is using the WAL journal node and the current page size is not the expected one, the journal node will be changed to TRUNCATE because WAL doesn't allow page size changes. The vacuum manager will try to restore WAL mode, but this will only work reliably if the participant properly resets statements. If the attempt to restore the journal node fails, it will remain TRUNCATE.



    Called when a vacuum operation begins. Once you receive this notification, you should avoid using the database until onEndVacuum() is called.

    boolean onBeginVacuum();


    Return value

    Return true to allow the vacuum operation to proceed, or false if you don't want the database to be vacuumed. You may wish to return false, for example, if you're in the middle of an operation that you don't want to (or can't) interrupt.


    Called when a vacuum operation ends.

    void onEndVacuum(
      in boolean aSucceeded
    true if the vacuum operation was successful, or false if it wasn't successful.

    Document Tags and Contributors

    Contributors to this page: Sheppy
    Last updated by: Sheppy,