mirror of
https://github.com/roytam1/UXP.git
synced 2026-05-26 13:58:49 +00:00
Moonchild
d388e478a0
Vim control lines were re-introduced or not entirely cleaned up. This nukes them again. Removing from the rest of js, caps, chrome, config, devtools, docshell, image, intl. More to come.
58 lines
2.5 KiB
Plaintext
58 lines
2.5 KiB
Plaintext
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
|
|
|
|
#include "nsISupports.idl"
|
|
|
|
interface nsIURI;
|
|
|
|
/**
|
|
* This interface can be used to add a download to history. There is a separate
|
|
* interface specifically for downloads in case embedders choose to track
|
|
* downloads differently from other types of history.
|
|
*/
|
|
[scriptable, uuid(4dcd6a12-a091-4f38-8360-022929635746)]
|
|
interface nsIDownloadHistory : nsISupports {
|
|
/**
|
|
* Adds a download to history. This will also notify observers that the
|
|
* URI aSource is visited with the topic NS_LINK_VISITED_EVENT_TOPIC if
|
|
* aSource has not yet been visited.
|
|
*
|
|
* @param aSource
|
|
* The source of the download we are adding to history. This cannot be
|
|
* null.
|
|
* @param aReferrer
|
|
* [optional] The referrer of source URI.
|
|
* @param aStartTime
|
|
* [optional] The time the download was started. If the start time
|
|
* is not given, the current time is used.
|
|
* @param aDestination
|
|
* [optional] The target where the download is to be saved on the local
|
|
* filesystem.
|
|
* @throws NS_ERROR_NOT_AVAILABLE
|
|
* In a situation where a history implementation is not available,
|
|
* where 'history implementation' refers to something like
|
|
* nsIGlobalHistory and friends.
|
|
* @note This addition is not guaranteed to be synchronous, since it delegates
|
|
* the actual addition to the underlying history implementation. If you
|
|
* need to observe the completion of the addition, use the underlying
|
|
* history implementation's notifications system (e.g. nsINavHistoryObserver
|
|
* for toolkit's implementation of this interface).
|
|
*/
|
|
void addDownload(in nsIURI aSource, [optional] in nsIURI aReferrer,
|
|
[optional] in PRTime aStartTime,
|
|
[optional] in nsIURI aDestination);
|
|
|
|
/**
|
|
* Remove all downloads from history.
|
|
*
|
|
* @note This removal is not guaranteed to be synchronous, since it delegates
|
|
* the actual removal to the underlying history implementation. If you
|
|
* need to observe the completion of the removal, use the underlying
|
|
* history implementation's notifications system (e.g. nsINavHistoryObserver
|
|
* for toolkit's implementation of this interface).
|
|
*/
|
|
void removeAllDownloads();
|
|
};
|