// GPG4Browsers - An OpenPGP implementation in javascript // Copyright (C) 2011 Recurity Labs GmbH // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Lesser General Public // License as published by the Free Software Foundation; either // version 3.0 of the License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, write to the Free Software // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA /** * @requires packet * @requires enums * @requires util */ import { readSimpleLength, writeSimpleLength } from './packet'; import enums from '../enums'; import util from '../util'; /** * Implementation of the User Attribute Packet (Tag 17) * * The User Attribute packet is a variation of the User ID packet. It * is capable of storing more types of data than the User ID packet, * which is limited to text. Like the User ID packet, a User Attribute * packet may be certified by the key owner ("self-signed") or any other * key owner who cares to certify it. Except as noted, a User Attribute * packet may be used anywhere that a User ID packet may be used. * * While User Attribute packets are not a required part of the OpenPGP * standard, implementations SHOULD provide at least enough * compatibility to properly handle a certification signature on the * User Attribute packet. A simple way to do this is by treating the * User Attribute packet as a User ID packet with opaque contents, but * an implementation may use any method desired. * @memberof module:packet */ class UserAttributePacket { constructor() { this.tag = enums.packet.userAttribute; this.attributes = []; } /** * parsing function for a user attribute packet (tag 17). * @param {Uint8Array} input payload of a tag 17 packet */ read(bytes) { let i = 0; while (i < bytes.length) { const len = readSimpleLength(bytes.subarray(i, bytes.length)); i += len.offset; this.attributes.push(util.uint8ArrayToStr(bytes.subarray(i, i + len.len))); i += len.len; } } /** * Creates a binary representation of the user attribute packet * @returns {Uint8Array} string representation */ write() { const arr = []; for (let i = 0; i < this.attributes.length; i++) { arr.push(writeSimpleLength(this.attributes[i].length)); arr.push(util.strToUint8Array(this.attributes[i])); } return util.concatUint8Array(arr); } /** * Compare for equality * @param {UserAttributePacket} usrAttr * @returns {Boolean} true if equal */ equals(usrAttr) { if (!usrAttr || !(usrAttr instanceof UserAttributePacket)) { return false; } return this.attributes.every(function(attr, index) { return attr === usrAttr.attributes[index]; }); } } export default UserAttributePacket;