Guide de migration vers Places

Création

Création d'un marque-page

// crée un nsIURI pour l'URL à marquer.
var bookmarkURI = Cc["@mozilla.org/network/io-service;1"].
                  getService(Ci.nsIIOService).
                  newURI("http://www.mozilla.com", null, null);

var bookmarkId = bookmarks.insertBookmark(
  bookmarks.toolbarFolder, // L'id du dossier dans lequel le marque-page sera placé.
  bookmarkURI,             // L'URI du marque-page — un objet nsIURI.
  bookmarks.DEFAULT_INDEX, // La position du marque-page dans son dossier parent.
  "mon titre");    // Le titre du marque-page.

Création d'un dossier

var folderId = bookmarks.createFolder(
  bookmarks.toolbarFolder, // L'id du dossier dans lequel le nouveau dossier sera placé.
  "mon dossier",           // Le titre du nouveau dossier .
  bookmarks.DEFAULT_INDEX);    // La position du nouveau dossier dans son dossier parent.

Création d'un séparateur

var separatorId = bookmarks.insertSeparator(
  bookmarks.toolbarFolder, //L'id du dossier dans lequel le séparateur sera placé.
  bookmarks.DEFAULT_INDEX);    // La position du séparateur dans son dossier parent.

Création d'un marque-page dynamique

var IOService = Cc["@mozilla.org/network/io-service;1"].
                  getService(Ci.nsIIOService);

var siteURI = IOService.newURI("http://www.mozilla.com", null, null);
var feedURI = IOService.newURI("http://www.mozilla.org/news.rdf", null, null);

var livemarks = Cc["@mozilla.org/browser/livemark-service;2"].
                getService(Ci.nsILivemarkService);

livemarks.createLivemark(bookmarks.toolbarFolder, // L'id du dossier dans lequel le marque-page dynamique sera placé.
  "Mon titre",        // Le titre du marque-page dynamique
  siteURI,                    // L'URI du site. Un objet nsIURI.
  feedURI,                    // L'URI du flux. Un objet nsIURI.
  bookmarks.DEFAULT_INDEX);   // La position du marque-page dynamique dans son dossier parent.

Lecture

var history = Cc["@mozilla.org/browser/nav-history-service;1"].
              getService(Ci.nsINavHistoryService);
var query = history.getNewQuery();
query.setFolders([myFolderId], 1);

var result = history.executeQuery(query, history.getNewQueryOptions());

// La propriété root d'un résultat de requête est un objet représentant le dossier spécifié plus haut.
var folderNode = result.root;

// Ouverture du dossier et parcours de son contenu.
folderNode.containerOpen = true;
for (var i=0; i < folderNode.childCount; ++i) {
  var childNode = folderNode.getChild(i);

  // Quelques propriétés des éléments.
  var title = childNode.title;
  var id = childNode.itemId;
  var type = childNode.type;
  
  // Quelques actions spécifiques selon le type.
  if (type == Ci.nsINavHistoryResultNode.RESULT_TYPE_URI) {

    var uri = childNode.uri;

  }
  else if (type == Ci.nsINavHistoryResultNode.RESULT_TYPE_FOLDER) {

    childNode.QueryInterface(Ci.nsINavHistoryContainerResultNode);
    childNode.containerOpen = true;
    // à présent vous pouvez parcourir les enfants d'un sous-dossier

  }
}

Mise à jour

Pour tous les éléments :

• setItemTitle(aItemId, aTitle) — Modifie le titre d'un élément.
• setItemIndex(aItemId, aIndex) — Modifie la position d'un élément. Note : ceci ne réindexe pas le dossier complet — utilisez moveItem pour une solution gérée.
• setItemDateAdded(aItemId, aDateAdded) — Définit la date d'ajout de l'élément, en microsecondes.
• setItemLastModified(aItemId, aLastModified) — Définit la date de dernière modification de l'élément, en microsecondes.
• setItemGUID(aItemId, aGUID) — Renvoie un identifiant globalement unique pour l'élément. Surtout utile pour les extensions synchronisant les données de marque-pages entre différents profils.
• moveItem (aFolderId, aNewParentId, aIndex) — Déplace un élément d'un dossier à un autre.

Pour les marque-pages :

• changeBookmarkURI(aItemId, aURI) — Change l'URI d'un marque-page.
• setKeywordForBookmark(aItemId, aKeyword) — Définit un mot-clié pour un marque-page.

Suppression

• Éléments
• Conteneurs

Observation

Import/export HTML

Sauvegarde/restauration

Nouveautés

• Balises
• Annotations
• Recherches enregistrées
• Conteneurs dynamiques

Ajout

Interrogation

Observation

Nouveautés