@ file : Js Qualifier (" browser . storage ") Ċ Ċ package Ġbrowser . storage Ċ Ċ import Ġkotlin . js . Promise Ċ Ċ /** Ċ Ġ* ĠItems Ġin Ġthe Ġsync Ġstorage Ġarea Ġare Ġsynced Ġusing ĠChrome ĠSync . Ċ Ġ*/ Ċ external Ġval Ġsync : ĠStorage Area Ċ Ċ /** Ċ Ġ* ĠItems Ġin Ġthe Ġlocal Ġstorage Ġarea Ġare Ġlocal Ġto Ġeach Ġmachine . Ċ Ġ*/ Ċ external Ġval Ġlocal : ĠStorage Area Ċ Ċ /** Ċ Ġ* ĠItems Ġin Ġthe Ġmanaged Ġstorage Ġarea Ġare Ġset Ġby Ġthe Ġdomain Ġadministrator , Ċ Ġ* Ġand Ġare Ġread - only Ġfor Ġthe Ġextension ; Ġtrying Ġto Ġmodify Ġthis Ġnamespace Ġresults Ġin Ġan Ġerror . Ċ Ġ* Ċ Ġ* ĠSince ĠChrome Ġ 3 3 . Ċ Ġ*/ Ċ external Ġval Ġmanaged : ĠStorage Area Ċ Ċ external Ġinterface ĠStorage Area Ġ{ ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠRetrieves Ġone Ġor Ġmore Ġitems Ġfrom Ġthe Ġstorage Ġarea . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġkeys ĠA Ġkey Ġ( string ) Ġor Ġkeys Ġ( an Ġarray Ġof Ġstrings Ġor Ġan Ġobject Ġspecifying Ġdefault ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġvalues ) Ġto Ġidentify Ġthe Ġitem ( s ) Ġto Ġbe Ġretrieved Ġfrom Ġstorage . ĠIf Ġyou Ġpass Ġan Ġempty ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġstring , Ġobject Ġor Ġarray Ġhere , Ġan Ġempty Ġobject Ġwill Ġbe Ġretrieved . ĠIf Ġyou Ġpass Ġnull , ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġor Ġan Ġundefined Ġvalue , Ġthe Ġentire Ġstorage Ġcontents Ġwill Ġbe Ġretrieved . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ return Ġa ĠPromise Ġthat Ġwill Ġbe Ġful filled Ġwith Ġa Ġresults Ġobject Ġcontaining Ġevery Ġobject ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġin Ġkeys Ġthat Ġwas Ġfound Ġin Ġthe Ġstorage Ġarea . ĠIf Ġthe Ġoperation Ġfailed , Ġthe Ġpromise ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġwill Ġbe Ġrejected Ġwith Ġan Ġerror Ġmessage . ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġget ( keys : Ġdynamic Ġ= Ġdefined Ex tern ally ): ĠPromise < dynamic > ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠStores Ġone Ġor Ġmore Ġitems Ġin Ġthe Ġstorage Ġarea , Ġor Ġupdate Ġexisting Ġitems . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠWhen Ġyou Ġstore Ġor Ġupdate Ġa Ġvalue Ġusing Ġthis ĠAPI , Ġthe Ġstorage . on Changed Ġevent Ġwill Ġfire . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġkeys ĠAn Ġobject Ġcontaining Ġone Ġor Ġmore Ġkey / value Ġpairs Ġto Ġbe Ġstored Ġin Ġstorage . ĊĠĠĠĠ Ġ* ĠĠĠĠĠ ĠIf Ġan Ġitem Ġalready Ġexists , Ġits Ġvalue Ġwill Ġbe Ġupdated . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġ- ĠValues Ġof Ġprimitive Ġtypes Ġ( number , Ġstring , Ġboolean , Ġnull , Ġundefined ) Ġwill Ġserialize ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ Ġ( omit ting Ġany Ġcustom Ġproperties ) ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ ĠNote : Ġin ĠChrome Ġpassing Ġundefined Ġwill Ġleave Ġthe Ġexisting Ġvalue Ġun touched , ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ Ġwhereas ĠFirefox Ġwill Ġset Ġit Ġto Ġnull ) ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġ- ĠD ates , Ġand ĠArrays , Ġwill Ġserialize Ġ( omit ting Ġany Ġcustom Ġproperties ) ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġ- ĠIn ĠFirefox , ĠReg Ex ps , ĠArray Buffers , ĠTyped ĠArrays / Array ĠViews Ġ( they Ġmake Ġa Ġcopy ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ Ġof Ġtheir Ġbuffer ), ĠMaps , Ġand ĠSet Ġs Ġwill Ġalso Ġserialize Ġ( omit ting Ġany Ġcustom Ġproperties ) ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġ- ĠObjects Ġcontaining Ġonly Ġthe Ġabove Ġtypes Ġwill Ġserialize Ġrecursively , ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ Ġbut Ġwill Ġlose Ġclass Ġinformation Ġ( and Ġso Ġpro totypes ) Ġfor Ġall Ġbut Ġthe Ġabove Ġtypes ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġ- ĠObjects Ġcontaining Ġproperties Ġwith Ġunsupported Ġtypes Ġwill Ġbe Ġrejected Ġwith Ġa ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ ĠData Clone Error Ġ( Firefox ) Ġor Ġhave Ġeach Ġunsupported Ġproperty Ġreplaced Ġby Ġthe ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ Ġempty Ġobject Ġ( other Ġimplementations ) ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġ- ĠUnsupported Ġtypes Ġ( Functions , ĠShared Array Buffers , ĠPromise s , ĠWeak Sets , ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ ĠErrors , ĠPro x ys , Ġetc ) Ġwill Ġbe Ġrejected Ġwith Ġa ĠData Clone Error Ġ( Firefox ) Ġor Ġare ĊĠĠĠĠ Ġ* ĠĠĠĠĠĠĠ Ġaccepted Ġand Ġsilently Ġreplaced Ġby Ġthe Ġempty Ġobject Ġ( other Ġimplementations ) ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ return ĠA ĠPromise Ġthat Ġwill Ġbe Ġful filled Ġwith Ġno Ġarguments Ġif Ġthe Ġoperation Ġsucceeded . ĊĠĠĠĠ Ġ* ĠĠĠĠĠ ĠIf Ġthe Ġoperation Ġfailed , Ġthe Ġpromise Ġwill Ġbe Ġrejected Ġwith Ġan Ġerror Ġmessage . ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġset ( keys : Ġdynamic ): ĠPromise < Unit > ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠRemoves Ġone Ġor Ġmore Ġitems Ġfrom Ġthe Ġstorage Ġarea . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ param Ġkeys ĠA Ġstring , Ġor Ġarray Ġof Ġstrings , Ġrepresenting Ġthe Ġkey ( s ) Ġof Ġthe Ġitem ( s ) Ġto Ġbe ĊĠĠĠĠ Ġ* ĠĠĠĠĠ Ġremoved . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ return ĠA ĠPromise Ġthat Ġwill Ġbe Ġful filled Ġwith Ġno Ġarguments Ġif Ġthe Ġoperation Ġsucceeded . ĊĠĠĠĠ Ġ* ĠĠĠĠĠ ĠIf Ġthe Ġoperation Ġfailed , Ġthe Ġpromise Ġwill Ġbe Ġrejected Ġwith Ġan Ġerror Ġmessage . ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġremove ( keys : Ġdynamic ): ĠPromise < Unit > ĊĊĠĠĠ Ġ/** ĊĠĠĠĠ Ġ* ĠRemoves Ġall Ġitems Ġfrom Ġthe Ġstorage Ġarea . ĊĠĠĠĠ Ġ* ĊĠĠĠĠ Ġ* Ġ@ return ĠA ĠPromise Ġthat Ġwill Ġbe Ġful filled Ġwith Ġno Ġarguments Ġif Ġthe Ġoperation Ġsucceeded . ĊĠĠĠĠ Ġ* ĠĠĠĠĠ ĠIf Ġthe Ġoperation Ġfailed , Ġthe Ġpromise Ġwill Ġbe Ġrejected Ġwith Ġan Ġerror Ġmessage . ĊĠĠĠĠ Ġ*/ ĊĠĠĠ Ġfun Ġclear (): ĠPromise < Unit > Ċ } Ċ