New function GetCustomProps has been added

- Add TmpDir field in the Options data type
- Update unit tests
- Upgrade the Excelize library version

Author: xuri

cmd/go.mod

@@ -4,8 +4,8 @@ go 1.23.0
 
 require (
 	github.com/stretchr/testify v1.10.0
-	github.com/xuri/excelize/v2 v2.9.2-0.20250614235856-d434acdde46b
-	golang.org/x/image v0.27.0
+	github.com/xuri/excelize/v2 v2.9.2-0.20250625074405-55e152f8492f
+	golang.org/x/image v0.28.0
 )
 
 require (

cmd/go.sum

@@ -13,14 +13,14 @@ github.com/tiendc/go-deepcopy v1.6.1 h1:uVRTItFeNHkMcLueHS7OCsxgxT9P8MzGB/taUa2Y
 github.com/tiendc/go-deepcopy v1.6.1/go.mod h1:toXoeQoUqXOOS/X4sKuiAoSk6elIdqc0pN7MTgOOo2I=
 github.com/xuri/efp v0.0.1 h1:fws5Rv3myXyYni8uwj2qKjVaRP30PdjeYe2Y6FDsCL8=
 github.com/xuri/efp v0.0.1/go.mod h1:ybY/Jr0T0GTCnYjKqmdwxyxn2BQf2RcQIIvex5QldPI=
-github.com/xuri/excelize/v2 v2.9.2-0.20250614235856-d434acdde46b h1:0+9AA5rFR07411NM9EdIagfecnG5weEFYgsiiPV/O+s=
-github.com/xuri/excelize/v2 v2.9.2-0.20250614235856-d434acdde46b/go.mod h1:isQygQdjiU88/HpJYtp+6TN/FH29HvVjWT8vFk3t5+w=
+github.com/xuri/excelize/v2 v2.9.2-0.20250625074405-55e152f8492f h1:ajRl2rx7253Gi6mpnfnoBe22xZF57Czyw7tDCWXgR00=
+github.com/xuri/excelize/v2 v2.9.2-0.20250625074405-55e152f8492f/go.mod h1:isQygQdjiU88/HpJYtp+6TN/FH29HvVjWT8vFk3t5+w=
 github.com/xuri/nfp v0.0.2-0.20250530014748-2ddeb826f9a9 h1:+C0TIdyyYmzadGaL/HBLbf3WdLgC29pgyhTjAT/0nuE=
 github.com/xuri/nfp v0.0.2-0.20250530014748-2ddeb826f9a9/go.mod h1:WwHg+CVyzlv/TX9xqBFXEZAuxOPxn2k1GNHwG41IIUQ=
 golang.org/x/crypto v0.39.0 h1:SHs+kF4LP+f+p14esP5jAoDpHU8Gu/v9lFRK6IT5imM=
 golang.org/x/crypto v0.39.0/go.mod h1:L+Xg3Wf6HoL4Bn4238Z6ft6KfEpN0tJGo53AAPC632U=
-golang.org/x/image v0.27.0 h1:C8gA4oWU/tKkdCfYT6T2u4faJu3MeNS5O8UPWlPF61w=
-golang.org/x/image v0.27.0/go.mod h1:xbdrClrAUway1MUTEZDq9mz/UpRwYAkFFNUslZtcB+g=
+golang.org/x/image v0.28.0 h1:gdem5JW1OLS4FbkWgLO+7ZeFzYtL3xClb97GaUzYMFE=
+golang.org/x/image v0.28.0/go.mod h1:GUJYXtnGKEUgggyzh+Vxt+AviiCcyiwpsl8iQ8MvwGY=
 golang.org/x/net v0.41.0 h1:vBTly1HeNPEn3wtREYfy4GZ/NECgw2Cnl+nK6Nz3uvw=
 golang.org/x/net v0.41.0/go.mod h1:B/K4NNqkfmg07DQYrbwvSluqCJOOXwUjeb/5lOisjbA=
 golang.org/x/text v0.26.0 h1:P42AVeLghgTYr4+xUnTRKDMqpar+PtX7KWuNQL21L8M=

cmd/main.go

@@ -363,6 +363,7 @@ func regInteropFunc(f *excelize.File, fn map[string]interface{}) interface{} {
 		"GetColWidth":                 GetColWidth(f),
 		"GetComments":                 GetComments(f),
 		"GetConditionalStyle":         GetConditionalStyle(f),
+		"GetCustomProps":              GetCustomProps(f),
 		"GetDefaultFont":              GetDefaultFont(f),
 		"GetDefinedName":              GetDefinedName(f),
 		"GetDocProps":                 GetDocProps(f),
@@ -2142,6 +2143,28 @@ func GetConditionalStyle(f *excelize.File) func(this js.Value, args []js.Value)
 	}
 }
 
+// GetCustomProps provides a function to get custom file properties.
+func GetCustomProps(f *excelize.File) func(this js.Value, args []js.Value) interface{} {
+	return func(this js.Value, args []js.Value) interface{} {
+		ret := map[string]interface{}{"props": []interface{}{}, "error": nil}
+		if err := prepareArgs(args, []argsRule{}); err != nil {
+			ret["error"] = err.Error()
+			return js.ValueOf(ret)
+		}
+		props, err := f.GetCustomProps()
+		if err != nil {
+			ret["error"] = err.Error()
+			return js.ValueOf(ret)
+		}
+		for _, prop := range props {
+			x := ret["props"].([]interface{})
+			x = append(x, js.ValueOf(map[string]interface{}{"Name": prop.Name, "Value": prop.Value}))
+			ret["props"] = x
+		}
+		return js.ValueOf(ret)
+	}
+}
+
 // GetDefaultFont provides the default font name currently set in the
 // workbook. The spreadsheet generated by excelize default font is Calibri.
 func GetDefaultFont(f *excelize.File) func(this js.Value, args []js.Value) interface{} {

cmd/main_test.go

@@ -2288,14 +2288,44 @@ func TestCustomProps(t *testing.T) {
 		assert.True(t, ret.Get("error").IsNull())
 	}
 
-	ret := f.(js.Value).Call("SetCustomProps")
+	ret := f.(js.Value).Call("GetCustomProps")
+	assert.Equal(t, ret.Get("props").Length(), 4)
+	assert.Equal(t, ret.Get("props").Index(0).Get("Value").String(), "text")
+	assert.True(t, ret.Get("props").Index(1).Get("Value").Bool())
+	assert.False(t, ret.Get("props").Index(2).Get("Value").Bool())
+	assert.Equal(t, ret.Get("props").Index(3).Get("Value").Float(), -123.456)
+
+	ret = f.(js.Value).Call("SetCustomProps")
 	assert.EqualError(t, errArgNum, ret.Get("error").String())
 
 	ret = f.(js.Value).Call("SetCustomProps", js.ValueOf(1))
 	assert.EqualError(t, errArgType, ret.Get("error").String())
 
 	ret = f.(js.Value).Call("SetCustomProps", js.ValueOf(map[string]interface{}{"Name": 1}))
 	assert.EqualError(t, errArgType, ret.Get("error").String())
+
+	ret = f.(js.Value).Call("GetCustomProps", js.ValueOf(1))
+	assert.EqualError(t, errArgNum, ret.Get("error").String())
+
+	// Test get custom property with unsupported charset
+	wb := excelize.NewFile()
+	wb.Sheet.Delete("docProps/custom.xml")
+	wb.Pkg.Store("docProps/custom.xml", MacintoshCyrillicCharset)
+	buf, err := wb.WriteToBuffer()
+	assert.NoError(t, err)
+
+	uint8Array := js.Global().Get("Uint8Array").New(js.ValueOf(buf.Len()))
+	for k, v := range buf.Bytes() {
+		uint8Array.SetIndex(k, v)
+	}
+	f = OpenReader(js.Value{}, []js.Value{uint8Array})
+	assert.True(t, f.(js.Value).Get("error").IsNull())
+	ret = f.(js.Value).Call("GetCustomProps")
+	assert.Equal(t, ret.Get("error").String(), "XML syntax error on line 1: invalid UTF-8")
+
+	// Test set custom property with unsupported charset
+	ret = f.(js.Value).Call("SetCustomProps", js.ValueOf(map[string]interface{}{"Name": "Text Prop", "Value": "text"}))
+	assert.Equal(t, ret.Get("error").String(), "XML syntax error on line 1: invalid UTF-8")
 }
 
 func TestSetDefaultFont(t *testing.T) {

src/index.d.ts

@@ -100,13 +100,17 @@ declare module 'excelize-wasm' {
    *
    * CultureInfo specifies the country code for applying built-in language
    * number format code these effect by the system's local language settings.
+   *
+   * TmpDir specifies the temporary directory for creating temporary files, if
+   * the value is empty, the system default temporary directory will be used.
    */
   export type Options = {
     MaxCalcIterations?: number;
     Password?:          string;
     RawCellValue?:      boolean;
     UnzipSizeLimit?:    number;
     UnzipXMLSizeLimit?: number;
+    TmpDir?:            string;
     ShortDatePattern?:  string;
     LongDatePattern?:   string;
     LongTimePattern?:   string;
@@ -2353,6 +2357,11 @@ declare module 'excelize-wasm' {
      */
     GetConditionalStyle(styleID: number): { style: Style, error: string | null }
 
+    /**
+     * GetCustomProps provides a function to get custom file properties.
+     */
+    GetCustomProps(): { props: CustomProperty[], error: string | null }
+
     /**
      * GetDefaultFont provides the default font name currently set in the
      * workbook. The spreadsheet generated by excelize default font is Calibri.