Nim/lib/std/jsformdata.nim at version-2-2 · nim-lang/Nim · GitHub

Name: Nim/lib/std/jsformdata.nim at version-2-2 · nim-lang/Nim · GitHub
Rating: 4.8 (7713 reviews)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
## - `FormData` for the JavaScript target: https://developer.mozilla.org/en-US/docs/Web/API/FormData
whennotdefined(js):
 {.fatal: "Module jsformdata is designed to be used with the JavaScript backend.".}

from std/dom importBlob

typeFormData*=refobjectofJsRoot## FormData API.

funcnewFormData*(): FormData {.importjs: "new FormData()".}

funcadd*(self: FormData; name: cstring; value: SomeNumber|bool|cstring|Blob) {.importjs: "#.append(#, #)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/append
##
## .. hint:: Duplicate keys are allowed and order is preserved.

funcadd*(self: FormData; name: cstring; value: SomeNumber|bool|cstring|Blob; filename: cstring) {.importjs: "#.append(#, #, #)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/append
##
## .. hint:: Duplicate keys are allowed and order is preserved.

funcdelete*(self: FormData; name: cstring) {.importjs: "#.$1(#)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/delete
##
## .. warning:: Deletes *all items* with the same key name.

funcgetAll*(self: FormData; name: cstring): seq[cstring] {.importjs: "#.$1(#)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/getAll

funchasKey*(self: FormData; name: cstring): bool {.importjs: "#.has(#)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/has

funckeys*(self: FormData): seq[cstring] {.importjs: "Array.from(#.$1())".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/keys

funcvalues*(self: FormData): seq[cstring] {.importjs: "Array.from(#.$1())".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/values

funcpairs*(self: FormData): seq[tuple[key, val: cstring]] {.importjs: "Array.from(#.entries())".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/entries

funcput*(self: FormData; name: cstring; value: SomeNumber|bool|cstring|Blob; filename: cstring) {.importjs: "#.set(#, #, #)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/set

func`[]=`*(self: FormData; name: cstring; value: SomeNumber|bool|cstring|Blob) {.importjs: "#.set(#, #)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/set

func`[]`*(self: FormData; name: cstring): cstring {.importjs: "#.get(#)".}
## https://developer.mozilla.org/en-US/docs/Web/API/FormData/get

funcclear*(self: FormData) {.importjs:
"(() => { const frmdt = #; Array.from(frmdt.keys()).forEach((key) => frmdt.delete(key)) })()".}
## Convenience func to delete all items from `FormData`.

functoCstring*(self: FormData): cstring {.importjs: "JSON.stringify(#)".}

func`$`*(self: FormData): string=$toCstring(self)

funclen*(self: FormData): int {.importjs: "Array.from(#.entries()).length".}


runnableExamples("-r:off"):
let data: FormData=newFormData()
 data["key0"] ="value0".cstring
 data.add("key1".cstring, "value1".cstring)
 data.delete("key1")
assert data.hasKey("key0")
assert data["key0"] =="value0".cstring
 data.clear()
assert data.len ==0