스크립트를 이용하여 사용자 프로파일(profile) 정보에 접속을 요청하고 읽기를 수행할 수 있는 방식을 제공한다.

Script parentObj.userProfile.methodName(arguments);
HTML 없다.
특기

만일 사이트에 프로파일 읽기가 없으면, 사용자는 요청 애트리뷰트 목록의 프롬프트를 선택하던가, 접속이 거절된다. 읽거나 쓰기 전에 요청하므로서, 여러 여러 요청에 한번만 허용받게 되므로 편리하게 한다.

적용
개체scriptHTML규격IE
clientInformation[sVal=]clientInformation.userProfile없음없음IE4.0(win16,win32,unix,mac),IE5.5(ce)
navigator[sVal=]navigator.userProfile없음없음IE4.0(win16,win32,unix,mac),IE5.5(ce)

property ⇒
userProfile⇒
userProfile⇒
개체견본예제
이전페이지로페이지 맨위로페이지 맨아래로
addReadRequest 메서드 IE4 -
⇒ vCard 읽기 요청을 추가하고 결과를 성공하면 true, 실패하면 false으로 부울값으로 반환한다.
문법: [window.]clientInformation.userProfileObj.addReadRequest(vCardAttributeName)
코드: document.write(clientInformation.userProfile.addReadRequest('vCard.Email')) 결과:
코드: document.write(clientInformation.userProfile.addReadRequest('vCard.Business.City')) 결과:
vCardAttributeName(vCard Names)
vCard.Business.City vCard.Business.Country vCard.Business.Fax
vCard.Business.Phone vCard.Business.State vCard.Business.StreetAddress
vCard.Business.URL vCard.Business.Zipcode vCard.Cellular
vCard.Company vCard.Department vCard.DisplayName
vCard.Email vCard.FirstName vCard.Gender*
vCard.Home.City vCard.Home.Country vCard.Home.Fax
vCard.Home.Phone vCard.Home.State vCard.Home.StreetAddress
vCard.Home.Zipcode vCard.Homepage vCard.JobTitle
vCard.LastName vCard.MiddleName vCard.Notes
vCard.Office vCard.Pager  
clearRequest 메서드 IE4 -
⇒ 읽기 요청을 모두 삭제하고 새로운 프로파일을 생성할 수 있게 준비한다. 반환값은 없다.
문법: [window.]clientInformation.userProfileObj.clearRequest()
코드: document.write(clientInformation.userProfile.clearRequest()) 결과: // 반환값은 없다.
doReadRequest 메서드 IE4 -
⇒ 지정한 모든 요청을 수행한다. 반환값은 없다.
문법: [window.]clientInformation.userProfileObj.doReadRequest(vUsageCode[, vFriendlyName][,vDomain][,vPath][,vExpiration][,vReserved])
코드: document.write(clientInformation.userProfile.doReadRequest(1)) 결과: // 반환값은 없다.
vUsageCode
필수 요소이고, 아래와 같이 사용자가 요청하는 접속 요청 타입 코드를 지정하는 정수이다.
사용코드는 IPWG(Internet Privacy Working Group)에 정의된 다음 중 하나이다.
0 system administration에 의해 사용된다.
1 연구나 개발자에 의해 사용된다.
2 현재의 교신을 지원하고 완료를 위하여 사용된다.
3 사이트 설계의 내용을 커스터마이즈하기 위해 사용된다.
4 광고를 포함하는 사이트의 내용을 개선하기 위해 사용된다.
5 사이트의 업데이트에 대해 방문자에게 알려줄 때 사용된다.
6 방문자에게 서비스나 제품의 마케팅을 위해 사용된다.
7 다른 집합 정보에 접속하기 위하여 사용된다.
8 사이트에서 다른 목적으로 사용된다.
9 사이트의 내용과 디자인의 커스터마이징이나 개선을 타인에게 공개한다.
10 제품이나 서비스의 마케팅을 위해 접촉할 수 있는 사용자에게 공개한다.
11 제품이나 서비스의 마케팅을 위해 접촉할 수 있는 사용자에게 금지사항을 공개한다.
12 다른 목적으로 타인에게 공개한다.
vFriendlyName
선택적인 요소이고, 개인 정보에 접속을 요청하는 사람의 이름을 표시하는 문자열이다. 보안의 목적으로, 사용도구가 사용자의 이름을 보여주는 것만으로는 부족하므로, 사용도구는 프로파일에 접속을 요청하는 스크립트의 원천 주소(URL)를 표시하여야 한다. 만일 원천 접속이 안전한 접속이면(SSL 인증등), 웹 작성자는 그 요청자를 확인하기 위하여 인증을 사용할 수 있다.
vDomain
선택적인 요소이고, 사용자가 선택하는 문서를 나타내는 문자열이며 쿠키(cookie) 표준을 따른다.
vPath
선택적인 요소이고, 접속을 요청하는 도메인 서버까지 경로의 문자열이다. vExpiration 를 지정하면 이 경로가 요청된 애트리뷰투에 저장된다.
vExpiration, vReserved
선택적인 요소이고, 아직 사용되지 않는다.
getAttribute 메서드 IE4 -
⇒ userProfileObj 개체로부터 애트리뷰트 이름(vCardAttributeName)을 반환한다.
문법: [window.]clientInformation.userProfileObj.getAttribute(vCardAttributeName)
코드: document.write(clientInformation.userProfile.getAttribute('vCard.Email')) 결과:
setAttribute 메서드 IE4 -
⇒ userProfileObj 개체에 지정된 애트리뷰트(vCardAttributeName)을 설정하며, 반환값은 없다.
이 setAttribute메서드는 getAttribute와 같이 거의 모든 엘레맨트에 폭넓게 사용된다.
문법: [window.]clientInformation.userProfileObj.setAttribute(vCardName,vValue[,iFlags])
코드: document.write(clientInformation.userProfile.setAttribute('vCard.Email',1)) 결과: // 반환값은 없다.
vCardName 필수적 요소 여기서는 vCardAttributeName 중의 하나이다.
vValue 필수적 요소 애트리뷰트를 지원하기 위한 문자열(String), 수치(Number), 부울(Boolean)을 지정한다.
iFlags 선택적 요소 다음 중 하나의 정수이다. 0은 대소문자에 관계없이 같은 이름의 애트리뷰트를 덮어씌워 설정하고, 디폴트 1은 대소문자를 구별한다.

property ⇒
userProfile⇒
userProfile⇒
개체메서드견본
이전페이지로페이지 맨위로페이지 맨아래로

userProfile 읽기 예제

<SCRIPT>
obj=navigator.userProfile; // object 이름 축약
vcName1='vCard.FirstName';
vcName2='vCard.Email';
str='<TABLE width=100% border=1><COL class=code><COL class=blue style=text-align:center><COL style=text-align:center>';
str+='<COL style=font-size:90%><TR><TH>코드</TH><TH>결과</TH><TH>반환값</TH><TH>설명</TH></TR>';
tr1='<TR><TD>';
tr2='</TD><TD>';
tr3='</TD></TR>';
obj.clearRequest();
str+=tr1+'obj.clearRequest()='+tr2+'&nbsp;'+tr2+' 없슴'+tr2+'요청 삭제'+tr3;
str+=tr1+'obj.setAttribute("'+vcName1+'","Taeho",0)='+tr2+obj.setAttribute(vcName1,'Taeho',0)+
  tr2+'없슴'+tr2+'설정'+tr3;
str+=tr1+'obj.setAttribute("'+vcName2+'","trio@trio.co.kr",0)='+tr2+obj.setAttribute(vcName2,'trio@trio.co.kr',0)+
  tr2+'없슴'+tr2+'설정'+tr3;
str+=tr1+'obj.addReadRequest("'+vcName1+'")='+tr2+obj.addReadRequest(vcName1)+
  r2+'true/false'+tr2+'읽기 허용 요청'+tr3;
str+=tr1+'obj.addReadRequest("'+vcName2+'")='+tr2+obj.addReadRequest(vcName2)+
  tr2+'true/false'+tr2+'읽기 허용 요청'+tr3;
obj.doReadRequest(2,'Taeho');
str+=tr1+'obj.doReadRequest(2,"Taeho")='+tr2+'&nbsp;'+  tr2+'없슴'+tr2+'해당 정보 접속 요청'+tr3;
name=obj.getAttribute(vcName1);
str+=tr1+'name=obj.getAttribute("'+vcName1+'")='+tr2+name+tr2+'이름'+tr2+'읽기 수행'+tr3;
email=obj.getAttribute(vcName2);
str+=tr1+'email=obj.getAttribute("'+vcName2+'")='+tr2+email+tr2+'이름'+tr2+'읽기 수행'+tr3;
str+='</TABLE>';
obj.clearRequest();
document.write(str);
</SCRIPT>

userProfile 예제

사용자 컴퓨터에서 수행하며 userProfile 개체를 사용하여 프로파일(profile)로부터 여러 정보들을 읽는다.

navigator.userProfile.addReadRequest('vcard.displayname'); // 복수 프로파일 속성들을 읽도록 요청한다.
navigator.userProfile.addReadRequest('vcard.gender');
navigator.userProfile.doReadRequest('vUsageCode','Acme Corporation'); // 한 정보에 접속하도록 요청한다.
name=navigator.userProfile.getAttribute('vcard.displayname'); // 요청한 정보에 접속하여 읽어 변수에 저장한다.
gender=navigator.userProfile.getAttribute('vcard.gender');
document.write(name+', '+gender); // 저장한 변수값을 출력하거나 개인용 내용이나 서버에 보내기 위하여 사용한다.
navigator.userProfile.clearRequest(); // 향 후 요청을 위하여 요청한 내용을 삭제한다.
property ⇒
userProfile
⇒
개체메서드견본예제
이전페이지로페이지 맨위로
최종 수정:
05/12/2025 02:50:57		KoXo Homepage
All right reserved		비정상적인 방식으로 프레임없이 페이지에 접속하면 자주 오류가 발생됩니다.
오류가 나면 정상적 접속으로 시도해 보세요.		http://koxo.com/lang/js/object/userProfile.html