info@a-coding-project.de

JavaScript: userProfile

Das clientseitige userProfile-Objekt beinhaltet Methoden es erlauben, Anfragen an die Nutzereinstellungen zu stellen. Das System ist recht einfach: Das Script erstellt eine List von Informationen, die benötigt werden. Ist die Liste komplett, wird diese an den Browser gesandt. Je nach (Sicherheits-)Einstellung werden die Informationen sofort oder erst durch Bestätigung durch den Benutzer an das Script zurück gegeben. Das Script kann diese Informationen dann auslesen und verarbeiten.

Methoden  nach oben

JScript 3.0 addReadRequest

Die addReadRequest-Methode fügt einen Request der Liste hinzu. Als Parameter wird als String eine vCard erwartet.
Notation: Objekt.addReadRequest(vCard)
Beispiel siehe doReadRequest.

JScript 3.0 clearRequest

Die clearRequest-Methode entfernt alle Anfragen aus der Liste. Es wird kein Parameter erwartet.
Notation: Objekt.clearRequest()
Beispiel siehe doReadRequest.

JScript 3.0 doReadRequestdoReadRequest

Die doReadRequest-Methode schickt die Liste der Anfragen an den Browser zur Weiterverarbeitung. Dazu wird als erster Parameter eine Zahl benötigt, die beschreibt, wozu die gesammelten Informationen benötigt werden. Dieser Verwendungszweck wird dem Benutzer angezeigt, folgende Werte sind definiert:

  • 0 - Systemadministration
  • 1 - Untersuchung und/oder Produktentwicklung.
  • 2 - Vervollständigung und Unterstützung einer Transaktion
  • 3 - Inhalts- und Designanpassung
  • 4 - Verbesserung des Inhalts auf Werbeseiten
  • 5 - Benachrichtigung des Benutzers über Updates
  • 6 - Kontaktieren des Benutzers zu Marketingzwecken
  • 7 - Herstellung von Verbindungen zu anderen Informationen
  • 8 - anderer Verwendungszweck
  • 9 - Weitergabe der Informationen an dritte um Inhalts- und Designanpassung durchführen zu können
  • 10 - Weitergabe der Informationen an dritte für Marketingzwecke
  • 11 - Weitergabe der Informationen an dritte für Marketingzwecke (mit Benutzereinschränkung/-verweigerung).
  • 12 - Weitergabe der Informationen an dritte für andere Verwendungszwecke.

Optional können 4 weitere Parameter übergeben werden, diese sind:

  • Name - Ein String, der den Namen des Informationssammelnden enthält.
  • Domain - Ein String, der die URL's enthält, von denen die Informationen zusätzlich verwendet werden. (u.a. bei 9 bis 12 ratsam)
  • Pfad - Ein String, der einen Pfad enthält unter dem die Informationen gespeichert werden sollen.
  • Verfallsdatum - Eine Zahl, die beschreibt, wie lange die Informationen verwendet werden dürfen (dieser Parameter wird ignoriert)

Notation: Objekt.doReadRequest(Zweck[,Name,Domain,Pfad,Datum])

a = navigator.userProfile;
a.addReadRequest('vCard.Business.URL');
a.addReadRequest('vCard.Email');
b = confirm('Dürfen wir einige Informationen von Ihnen '+
            'abspeichern?');
if(b == true)
{
 a.doReadRequest(1,'Meine Firma','http://www.domain.de','/abc/',1000*60*60*24*365);
 c = a.getAttribute('vCard.Business.URL');
 d = a.getAttribute('vCard.Email');
 location.href = 'speichere.php?url='+
                 escape(c)+'&mail='+escape(d);
}
else
{
 a.clearRequest();
}

JScript 3.0 getAttribute

Die getAttribute-Methode ermittelt den Wert einer abgefragten Eigenschaft. Als Parameter wird als String eine vCard erwartet.
Notation: Objekt.getAttribute(vCard)
Beispiel siehe doReadRequest.

JScript 3.0 setAttribute

Die setAttribute-Methode hat im eigentlichen Sinne nichts mit dem userProfile-Objekt zu tun. Sie erzeugt eine neue Eigenschaft des Objekts und setzt einen bestimmten Wert. Als Parameter werden dazu der Name sowie der zu setzende Wert (in dieser Reihenfolge) erwartet. Optional kann als dritter Parameter eine Zahl übergeben werden. Diese besagt, ob ein evtl. zuvor bestehendes Attribut mit dem gleichen Namen überschrieben werden soll (0) oder nicht (1 / Standard).
Notation: Objekt.setAttribute(Name,Wert[,Überschreiben])

navigator.userProfile.setAttribute('abc','def'); 
a = navigator.userProfile.abc; // = 'def';

Über uns

Stefan Wienströer

Wir entwickeln Webanwendungen mit viel Leidenschaft. Unser Wissen geben wir dabei gerne weiter. Mehr über a coding project

Auch interessant