Rename existing form field name

[StefanZivkovic]

Hi,

When I retrieve pdf fields for doc const fields = (await PDFDocument.load(content)).getForm().getFields() I would like to rename existing form field name. I have found that I am able to do something like this fields[1].acroField.setPartialName('new field name'), where setPartialName definition is like this:

setPartialName(partialName: string | undefined) {
    if (!partialName) this.dict.delete(PDFName.of('T'));
    else this.dict.set(PDFName.of('T'), PDFHexString.fromText(partialName));
  }

I can confirm that this seems to work. But I have question: is this valid action and does it have some (unexpected) side-effects?

02 Feb 2022, EDIT: upload with new discovery which I posted on this question as well #600

I notice that setPartialName fits my needs when there is no dot . in form field name, and it is not working when i have dot. Not sure if there are similar limitations for other non-alphanumeric characters.

My need is to apply newPrefix. (read any kind of prefix with dot - in 99,9% of cases characters with underscores and one dot at the end) to existing name of form field.
Example when is (not)working:

working: nameWithoutPrefix -> after setPartialName-> newPrefix.nameWithoutPrefix
not working: group1.checkbox1 -> after setPartialName -> group1.newPrefix.group1.checkbox1