w3c / FileAPI

File API
https://w3c.github.io/FileAPI/
Other
104 stars 44 forks source link

Disallow mutating state of Blob/File objects #75

Open annevk opened 7 years ago

annevk commented 7 years ago

In particular, I think we should no longer add something like close() and make that an invariant of these objects.

That way there's no longer a need for defensive cloning (through serializing/deserializing) of these objects, which helps with https://github.com/whatwg/url/issues/277.

Making a note of this somewhere in the document seems sufficient.

mkruisselbrink commented 7 years ago

I agree that defining Blob/File as fully immutable (which they more or less already are currently) would definitely be a nice thing. I'm not sure if we can really get rid of defensive cloning though. For example reading a File can always cause a NotReadableError if the snapshot state of the File no longer matches the state of the underlying storage (although the whole concept of this snapshot state isn't defined very well. I don't think we want to start requiring user agents to actually do defensive cloning themselves every time they create a File).

annevk commented 7 years ago

Defensive cloning doesn't help with snapshot state I think, since we wouldn't want to require cloning to copy the bytes, cloning should just copy a pointer.

mkruisselbrink commented 7 years ago

Ah yes, good point. So yeah, I should definitely add a note somewhere to make it explicit that blob's are immutable, noting that the snapshot state might still cause the same operation on the same blob to behave differently at different times.

andrew-aladev commented 5 years ago

I agree that defining Blob/File as fully immutable (which they more or less already are currently) would definitely be a nice thing.

I don't think so. You like functional programming. You just forgot that you are making API for whole Earth. Some people don't like it. Why do you think that you can force your programming style?

andrew-aladev commented 5 years ago

In particular, I think we should no longer add something like close() and make that an invariant of these objects.

If you don't want to maintain blob/file state inside - people will have to invent their own bicycle wrapper that does this (with some method like toNative()). If you are going to make user applications more error prone - you are doing fine job.

guest271314 commented 5 years ago

@andrew-aladev If toNative() only sets the name property of the File object FormData set() method can be utilized https://github.com/w3c/FileAPI/issues/126#issuecomment-480956457